Aktualizacja plików w Laravel: Dlaczego POST zamiast PUT i pole _method

5 min. czytaniaZaktualizowano

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 danych
  • POST - tworzenie nowych zasobów
  • PUT - aktualizacja istniejących zasobów (całkowite zastąpienie)
  • PATCH - częściowe aktualizacje
  • DELETE - usuwanie zasobów

Aktualizacja powinna być PUT lub PATCH. Z plikami się nie da.

Ograniczenie przesyłania plików

  1. Żądania POST mogą obsługiwać kodowanie multipart/form-data, które jest wymagane do przesyłania plików
  2. Żądania PUT z multipart/form-data nie są parsowane przez samo PHP: przed PHP 8.4 $_POST i $_FILES były wypełniane tylko dla POST, więc multipartowy PUT lub PATCH docierał z pustym body (aktualny Symfony na PHP 8.4+ to parsuje, ale nie na każdym środowisku możesz na tym polegać)
  3. Formularze HTML mogą wysyłać tylko GET i POST

Rozwiązanie: Podszywanie się pod metodę (Method Spoofing)

Laravel rozwiązuje to przez “method spoofing” z polem _method.

Jak działa Method Spoofing

javascript
// 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):

jsx
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
<?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):

jsx
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):

php
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):

php
Route::resource('posts', PostController::class);

Kluczowe różnice między Create a Update

AspektCreate (POST)Update (POST + _method: PUT)
Metoda HTTPPOSTPOST (z _method: 'PUT')
Trasa/posts/posts/{id}
Dane formularzaStandardowe polaStandardowe pola + _method
Metoda Laravelstore()update()
CelUtworzenie nowego zasobuAktualizacja 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:

javascript
submit(`/posts/${post.id}`, {
    forceFormData: true, // To zapewnia prawidłowe kodowanie multipart
});

2. Walidacja plików

Waliduj typ i rozmiar każdego uploadu:

php
$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

javascript
// ❌ 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

javascript
// ❌ 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

php
// ❌ 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.

Powiązane artykuły

Wsparcie istniejącego systemu

Potrzebujesz pomocy z działającą aplikacją?

Pomagam firmom rozwijać działające systemy, porządkować wdrożenia i dodawać nowe funkcje bez dokładania chaosu do projektu.

Komentarze (0)
Zaloguj się, aby dodać komentarz

Musisz być zalogowany, aby dodać komentarz.

Zaloguj się

Potrzebujesz kogoś, kto weźmie odpowiedzialność za kolejny krok?

Porozmawiajmy o Twoim projekcie i określmy zakres, który ma sens dla Twoich celów.