Laravel Method Not Allowed Hatası Nasıl Çözülür?

Laravel Method Not Allowed hatası, bir URL'ye gönderilen HTTP isteğinin kullanılan route tarafından desteklenmemesi durumunda ortaya çıkar. Örneğin form POST isteği gönderirken Laravel'de aynı URL yalnızca GET olarak tanımlanmışsa Method Not Allowed hatası alınır. Bu rehberde Laravel 405 Method Not Allowed hatasının nedenlerini ve çözüm yöntemlerini adım adım inceleyeceğiz.

1. Laravel Method Not Allowed Hatası Nedir?

Laravel'de her route belirli HTTP metotlarını kabul eder. Bunlar genellikle GET, POST, PUT, PATCH ve DELETE metotlarıdır.
Örneğin:
Route::get('/products', [ProductController::class, 'index']);
Bu route yalnızca GET isteğini kabul eder.
Aynı adrese POST isteği gönderildiğinde Laravel Method Not Allowed hatası döndürebilir.

2. 405 Method Not Allowed Hatası Neden Oluşur?

En yaygın nedenler şunlardır:

• GET yerine POST gönderilmesi
• POST yerine GET gönderilmesi
• Form method değerinin yanlış olması
• Route metodunun yanlış tanımlanması
• PUT veya DELETE isteğinin yanlış gönderilmesi
• Resource route yapısının yanlış kullanılması
• Route cache'in eski olması
• AJAX isteğinin yanlış HTTP metodu kullanması

3. Route Metodunu Kontrol Edin

Öncelikle ilgili route'un hangi HTTP metodunu kabul ettiğini kontrol edin.
Örneğin:
Route::post('/products', [ProductController::class, 'store'])->name('products.store');
Bu route'a POST isteği gönderilmelidir.
Form:
<form method="POST" action="{{ route('products.store') }}">
şeklinde olmalıdır.

4. Form Method Değerini Kontrol Edin

Laravel form gönderimlerinde method değerinin route ile aynı olması gerekir.
Örneğin route:
Route::post('/contact', [ContactController::class, 'store'])->name('contact.store');
Form:
<form method="POST" action="{{ route('contact.store') }}">
şeklinde olmalıdır.
Route POST beklerken form GET gönderirse Method Not Allowed hatası oluşabilir.

5. PUT ve PATCH İsteklerini Kontrol Edin

HTML formları doğrudan PUT veya PATCH gönderemez. Laravel'de method spoofing kullanılabilir.
Örneğin:
<form method="POST" action="{{ route('products.update', $product) }}">
Ardından:
@csrf
@method('PUT')
kullanılır.
Route:
Route::put('/products/{product}', [ProductController::class, 'update'])->name('products.update');
şeklinde tanımlanabilir.

6. DELETE İsteğini Kontrol Edin

Silme işlemlerinde Laravel'de genellikle:
<form method="POST" action="{{ route('products.destroy', $product) }}">
@csrf
@method('DELETE')
kullanılır.
Route:
Route::delete('/products/{product}', [ProductController::class, 'destroy'])->name('products.destroy');
şeklinde olmalıdır.

7. php artisan route:list Komutunu Kullanın

Laravel'de route'ların hangi HTTP metodlarını kabul ettiğini görmek için:
php artisan route:list
komutunu çalıştırabilirsiniz.
Çıktıda:
GET|HEAD
POST
PUT
PATCH
DELETE
gibi HTTP metodlarını görebilirsiniz.
İsteğin kullandığı metot ile route'un kabul ettiği metodun aynı olduğundan emin olun.

8. Route Cache Temizleyin

Route değişikliği yaptıysanız eski route cache sorun oluşturabilir.
Önce:
php artisan route:clear
Ardından:
php artisan optimize:clear
komutlarını çalıştırabilirsiniz.
Sonrasında:
php artisan route:list
ile güncel route'ları kontrol edin.

9. AJAX ve Fetch İsteklerini Kontrol Edin

JavaScript ile API veya web route'una istek gönderiyorsanız HTTP metodunu kontrol edin.
Örneğin:
fetch('/products', { method: 'POST' })
kullanıyorsanız Laravel tarafında ilgili route'un POST kabul etmesi gerekir.
Route:
Route::post('/products', [ProductController::class, 'store']);
şeklinde olmalıdır.

10. Axios Kullanırken Method Kontrolü

Axios ile:
axios.post('/products', data)
kullanıyorsanız Laravel route'unun POST kabul ettiğinden emin olun.
Yanlış HTTP metodu kullanıldığında Laravel 405 hatası döndürebilir.

11. Resource Controller Route'larını Kontrol Edin

Laravel resource route'ları otomatik olarak farklı HTTP metodları oluşturur.
Örneğin:
Route::resource('products', ProductController::class);
Bu yapı içerisinde index için GET, store için POST, update için PUT/PATCH, destroy için DELETE route'ları oluşturulur.
Hangi işlemin hangi metoda ait olduğunu:
php artisan route:list
ile kontrol edebilirsiniz.

12. Route Sıralamasını Kontrol Edin

Benzer URL'lere sahip route'larda tanımların sırası ve parametre yapısı önemlidir.
Örneğin:
Route::get('/products/create', [ProductController::class, 'create']);
Route::get('/products/{product}', [ProductController::class, 'show']);
gibi route'ların yapısı dikkatli düzenlenmelidir.
Method Not Allowed alıyorsanız öncelikle route:list çıktısındaki gerçek eşleşmeyi kontrol edin.

13. GET ve POST Route'larını Birlikte Kullanabilirsiniz

Aynı URL için farklı HTTP metodları tanımlanabilir.
Örneğin:
Route::get('/contact', [ContactController::class, 'create'])->name('contact.form');
Route::post('/contact', [ContactController::class, 'store'])->name('contact.store');
Böylece GET formu görüntüler, POST ise formu işler.

14. Route::match Kullanımı

Bir route'un birden fazla HTTP metodunu kabul etmesi gerekiyorsa:
Route::match(['get', 'post'], '/contact', [ContactController::class, 'contact']);
kullanılabilir.
Ancak uygulamanın ihtiyaç duymadığı HTTP metodlarını gereksiz yere açmak yerine işlemin amacına uygun route tanımlamak daha kontrollü bir yaklaşımdır.

15. Route::any Kullanımına Dikkat Edin

Laravel'de:
Route::any('/test', [TestController::class, 'index']);
birden fazla HTTP metodunu kabul edebilir.
Ancak her route'u any yapmak yerine yalnızca ihtiyaç duyulan HTTP metodunun kullanılması daha kontrollü bir route yapısı sağlar.

16. CSRF ile Method Not Allowed Aynı Hata Değildir

Laravel'de CSRF token problemi ile Method Not Allowed farklı sorunlardır.
CSRF sorunu genellikle:
419 Page Expired
gibi bir hata oluşturabilir.
Method Not Allowed ise gönderilen HTTP metodunun route tarafından kabul edilmediğini gösterir.
Bu nedenle iki hatayı birbirine karıştırmamak gerekir.

17. API Route'larında HTTP Method Kontrolü

API route'larında da HTTP metodu önemlidir.
Örneğin:
Route::post('/products', [ProductController::class, 'store']);
şeklindeki endpoint'e GET isteği gönderilirse 405 hatası oluşabilir.
İstek gönderen frontend, mobil uygulama veya API istemcisindeki HTTP metodunu kontrol edin.

18. Postman ile Test Ediyorsanız

Postman kullanırken URL'nin yanında seçilen HTTP metodunu kontrol edin.
Örneğin Laravel:
POST /api/products
bekliyorsa Postman'da:
POST
seçilmelidir.
GET
seçilirse Method Not Allowed hatası alabilirsiniz.

19. Production Ortamında Route Kontrolü

Local bilgisayarda çalışan route production sunucusunda farklı olabilir.
Sunucuda:
php artisan route:list
çalıştırarak gerçek production route'larını kontrol edin.
Ardından:
php artisan route:clear
ve:
php artisan optimize:clear
komutlarını uygulayabilirsiniz.

20. Laravel Method Not Allowed Hatası İçin Hızlı Kontrol

Sorunu hızlı çözmek için şu sırayla ilerleyin:
php artisan route:list
İsteğin HTTP metodunu kontrol edin.
Formdaki method değerini kontrol edin.
AJAX veya Axios metodunu kontrol edin.
PUT, PATCH veya DELETE kullanıyorsanız @method() kontrol edin.
Gerekirse:
php artisan route:clear
php artisan optimize:clear
komutlarını çalıştırın.

Sık Sorulan Sorular

1. Laravel Method Not Allowed hatası nedir? Gönderilen HTTP isteğinin ilgili route tarafından desteklenmediğini gösteren hatadır.
2. Laravel 405 hatası neden oluşur? Genellikle GET, POST, PUT, PATCH veya DELETE metodunun route ile uyuşmaması nedeniyle oluşur.
3. Laravel Method Not Allowed nasıl çözülür? php artisan route:list ile route metodunu kontrol edip gönderilen HTTP metoduyla eşleştirmek gerekir.
4. Laravel form POST yerine GET gönderirse ne olur? Route yalnızca POST kabul ediyorsa Laravel Method Not Allowed hatası verebilir.
5. Laravel PUT isteği nasıl gönderilir? Formda POST kullanıp @method('PUT') ile Laravel method spoofing özelliğinden yararlanabilirsiniz.
6. Laravel DELETE isteği nasıl gönderilir? Formda POST kullanıp @method('DELETE') kullanılabilir.
7. Laravel route:list ne işe yarar? Projedeki route'ları, HTTP metodlarını, URL'leri ve route isimlerini görmenizi sağlar.
8. Laravel route cache 405 hatasına neden olabilir mi? Route değişiklikleri eski cache nedeniyle yansımadıysa sorun yaşanabilir. Route cache temizlenebilir.
9. Laravel AJAX Method Not Allowed neden verir? JavaScript isteğinde kullanılan HTTP metodu Laravel route'unun kabul ettiği metodla uyuşmuyor olabilir.
10. Axios POST isteği neden 405 verir? İstek gönderilen URL'nin Laravel tarafında POST route'u bulunmuyor olabilir.
11. Laravel GET ve POST aynı URL'de kullanılabilir mi? Evet. Aynı URL için farklı HTTP metodlarına sahip route'lar tanımlanabilir.
12. Laravel Resource Controller 405 hatası neden verir? Resource route'un oluşturduğu HTTP metoduyla gönderilen isteğin uyuşmaması nedeniyle oluşabilir.
13. Laravel CSRF hatası ile 405 aynı mı? Hayır. CSRF problemi ve HTTP method uyuşmazlığı farklı hatalardır.
14. Laravel API'de Method Not Allowed neden olur? API endpoint'inin beklediği HTTP metodundan farklı bir metot kullanılmış olabilir.
15. Postman'da Laravel 405 hatası nasıl çözülür? Postman içerisindeki HTTP metodunun Laravel route'unda tanımlanan metotla aynı olduğunu kontrol edin.
16. Laravel route:clear ne işe yarar? Laravel'in route cache'ini temizler.
17. Laravel optimize:clear 405 hatasını çözer mi? Eski cache kaynaklı bir problem varsa yardımcı olabilir ancak yanlış HTTP metodunu düzeltmez.
18. Laravel'de Route::match ne işe yarar? Belirtilen birden fazla HTTP metodunun aynı route tarafından kabul edilmesini sağlar.
19. Laravel Route::any kullanılmalı mı? Gereksiz yere tüm HTTP metodlarını açmak yerine ihtiyaç duyulan metodun açıkça belirtilmesi daha kontrollü bir yapı sağlar.
20. Laravel Method Not Allowed hatasında ilk ne kontrol edilmeli? İlk olarak php artisan route:list ile ilgili URL'nin hangi HTTP metodunu kabul ettiği kontrol edilmelidir.