Gdy aktualizujesz rekord z uploadem pliku w Laravel i Inertia.js, wysyłasz POST z _method: "PUT" zamiast prawdziwego PUT. Oto dlaczego i jak to zaimplementować.
Problem: Metody HTTP i przesyłanie plików
Zrozumienie metod HTTP
W RESTful API różne metody HTTP służą konkretnym celom:
GET- pobieranie danychPOST- tworzenie nowych zasobówPUT- aktualizacja istniejących zasobów (całkowite zastąpienie)PATCH- częściowe aktualizacjeDELETE- usuwanie zasobów
Aktualizacja powinna być PUT lub PATCH. Z plikami się nie da.
Ograniczenie przesyłania plików
- Żądania POST mogą obsługiwać kodowanie
multipart/form-data, które jest wymagane do przesyłania plików - Żądania PUT z
multipart/form-datanie są parsowane przez samo PHP: przed PHP 8.4$_POSTi$_FILESbyły wypełniane tylko dlaPOST, więc multipartowyPUTlubPATCHdocierał z pustym body (aktualny Symfony na PHP 8.4+ to parsuje, ale nie na każdym środowisku możesz na tym polegać) - Formularze HTML mogą wysyłać tylko
GETiPOST
Rozwiązanie: Podszywanie się pod metodę (Method Spoofing)
Laravel rozwiązuje to przez “method spoofing” z polem _method.
Jak działa Method Spoofing
// Zamiast tego (multipartowy PUT nie jest parsowany na starszych konfiguracjach PHP/Symfony):
router.put('/posts/1', {
title: 'Zaktualizowany tytuł',
content: 'Zaktualizowana treść',
image: fileObject // Może dotrzeć pusty
});
// Używamy tego:
router.post('/posts/1', {
_method: 'PUT',
title: 'Zaktualizowany tytuł',
content: 'Zaktualizowana treść',
image: fileObject // To działa!
});
Middleware Laravel przechwytuje pole _method i traktuje żądanie tak, jakby zostało wysłane określoną metodą HTTP.
Przykłady implementacji
Operacja Create (standardowy POST)
Frontend (React z Inertia.js):
import { useForm } from '@inertiajs/react';
function CreatePost() {
const { data, setData, post, processing, errors } = useForm({
title: '',
content: '',
image: null,
});
const handleSubmit = (e) => {
e.preventDefault();
post('/posts', {
forceFormData: true, // Zapewnia multipart/form-data
});
};
return (
<form onSubmit={handleSubmit}>
<input
type="text"
value={data.title}
onChange={e => setData('title', e.target.value)}
placeholder="Tytuł"
/>
<textarea
value={data.content}
onChange={e => setData('content', e.target.value)}
placeholder="Treść"
/>
<input
type="file"
onChange={e => setData('image', e.target.files[0])}
/>
<button type="submit" disabled={processing}>
Utwórz post
</button>
</form>
);
}
Backend (kontroler Laravel):
<?php
namespace App\Http\Controllers;
use App\Models\Post;
use Illuminate\Http\Request;
class PostController extends Controller
{
public function store(Request $request)
{
$validated = $request->validate([
'title' => 'required|string|max:255',
'content' => 'required|string',
'image' => 'nullable|image|max:2048',
]);
if ($request->hasFile('image')) {
$validated['image'] = $request->file('image')->store('posts', 'public');
}
Post::create($validated);
return redirect()->route('posts.index')
->with('success', 'Post został utworzony pomyślnie!');
}
}
Operacja Update (POST z _method: PUT)
Frontend (React z Inertia.js):
import { useForm } from '@inertiajs/react';
function EditPost({ post }) {
const { data, setData, post: submit, processing, errors } = useForm({
title: post.title,
content: post.content,
image: null,
_method: 'PUT', // To jest kluczowe!
});
const handleSubmit = (e) => {
e.preventDefault();
// Uwaga: Używamy POST tutaj, nie PUT
submit(`/posts/${post.id}`, {
forceFormData: true,
});
};
return (
<form onSubmit={handleSubmit}>
<input
type="text"
value={data.title}
onChange={e => setData('title', e.target.value)}
placeholder="Tytuł"
/>
<textarea
value={data.content}
onChange={e => setData('content', e.target.value)}
placeholder="Treść"
/>
<input
type="file"
onChange={e => setData('image', e.target.files[0])}
/>
{post.image && (
<div>
<p>Aktualne zdjęcie:</p>
<img src={`/storage/${post.image}`} alt="Aktualny" width="200" />
</div>
)}
<button type="submit" disabled={processing}>
Zaktualizuj post
</button>
</form>
);
}
Backend (kontroler Laravel):
use Illuminate\Support\Facades\Storage;
public function update(Request $request, Post $post)
{
$validated = $request->validate([
'title' => 'required|string|max:255',
'content' => 'required|string',
'image' => 'nullable|image|max:2048',
]);
// Obsługa przesyłania pliku
if ($request->hasFile('image')) {
// Usuń stary obrazek jeśli istnieje
if ($post->image) {
Storage::disk('public')->delete($post->image);
}
$validated['image'] = $request->file('image')->store('posts', 'public');
} else {
// Inertia wysyła puste pole "image", które nadpisałoby kolumnę wartością null
unset($validated['image']);
}
$post->update($validated);
return redirect()->route('posts.index')
->with('success', 'Post został zaktualizowany pomyślnie!');
}
Trasy (web.php):
Route::resource('posts', PostController::class);
Kluczowe różnice między Create a Update
| Aspekt | Create (POST) | Update (POST + _method: PUT) |
|---|---|---|
| Metoda HTTP | POST | POST (z _method: 'PUT') |
| Trasa | /posts | /posts/{id} |
| Dane formularza | Standardowe pola | Standardowe pola + _method |
| Metoda Laravel | store() | update() |
| Cel | Utworzenie nowego zasobu | Aktualizacja istniejącego zasobu |
Ważne uwagi konfiguracyjne
1. Konfiguracja Inertia.js
Inertia samo przełącza się na multipart/form-data, gdy dane zawierają File, ale forceFormData: true czyni to jawnym i obejmuje też przypadek, gdy nie wybrano pliku:
submit(`/posts/${post.id}`, {
forceFormData: true, // To zapewnia prawidłowe kodowanie multipart
});
2. Walidacja plików
Waliduj typ i rozmiar każdego uploadu:
$request->validate([
'image' => 'nullable|image|mimes:jpeg,png,jpg,gif|max:2048',
]);
Częste pułapki i rozwiązania
Pułapka 1: Używanie rzeczywistego żądania PUT dla plików
// ❌ Multipartowy PUT nie jest parsowany na starszych konfiguracjach PHP/Symfony
router.put('/posts/1', formData);
// ✅ Użyj tego zamiast
router.post('/posts/1', {
...formData,
_method: 'PUT'
});
Pułapka 2: Zapomnienie o forceFormData
// ❌ Polega na wykryciu obiektu File przez Inertia; bez wybranego pliku dane idą jako JSON
submit(`/posts/${post.id}`);
// ✅ Bądź jawny z forceFormData
submit(`/posts/${post.id}`, {
forceFormData: true
});
Pułapka 3: Nieobsługiwanie istniejących plików
// ❌ To spowoduje utratę istniejącego obrazka jeśli nie zostanie przesłany nowy
// ($rules zawiera 'image' => 'nullable|image|max:2048')
public function update(Request $request, Post $post)
{
$post->update($request->validate($rules));
}
// ✅ Prawidłowo obsłuż aktualizacje plików
public function update(Request $request, Post $post)
{
$validated = $request->validate($rules);
if ($request->hasFile('image')) {
// Usuń stary obrazek
if ($post->image) {
Storage::disk('public')->delete($post->image);
}
$validated['image'] = $request->file('image')->store('posts', 'public');
} else {
unset($validated['image']);
}
$post->update($validated);
}
Podsumowanie
Przy uploadzie plików w aktualizacjach wysyłaj POST z _method: "PUT" i forceFormData: true. Podszyta metoda nadal trafia do update() w kontrolerze zasobów, więc routing się nie zmienia.