There are five core steps to handle form submission in Laravel: first, define POST routes in web.php, such as Route::post('/submit-form', [FormController::class, 'handleForm']) and make sure that the form contains @csrf; second, use Artisan to create a controller and define the handleForm method to receive the Request object to obtain the input value; third, use the validate() method to verify the input data and display error messages with Blade; fourth, if the file is uploaded, add the enctype="multipart/form-data" attribute and call the file() method in the controller to store the file; finally run php artisan storage:link to make the uploaded file publicly accessible.

Handling form submissions in Laravel is straightforward once you understand the basic flow. At its core, it involves setting up a route, creating a controller method to process the data, and using Laravel's built-in features like validation and CSRF protection. Here's how to do it right.

Setting Up Routes

Before handling any form submission, you need a route that listens for POST requests. In Laravel, routes are typically defined in web.php . For example:

 Route::post('/submit-form', [FormController::class, 'handleForm']);

Make sure your form's action attribute matches this route and uses the POST method. Also, every form in Laravel should include a CSRF token:

 <form action="/submit-form" method="POST">
    @csrf
    <!-- form fields go here -->
</form>

This helps prevent cross-site request forgery attacks.

Creating a Controller Method

Once the route is set up, create a controller (if you haven't already) using Artisan:

 php artisan make:controller FormController

Then, in your controller, add a method to handle the form data:

 public function handleForm(Request $request)
{
    // Process the form data here
}

The $request object contains all the input values ??from your form. You can access them like this:

 $name = $request->input('name');
$email = $request->input('email');

Just remember to import the Request class at the top of your controller:

 use Illuminate\Http\Request;

Validating Form Input

Laravel provides a clean way to validate form inputs using the validate() method. Here's an example inside your controller method:

 $request->validate([
    'name' => 'required|string|max:255',
    'email' => 'required|email|max:255',
]);

If validation fails, Laravel will automatically redirect the user back with errors. You can display those errors in your view using Blade syntax:

 @if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

You can also customize error messages if needed:

 $request->validate([
    'name' => 'required|string|max:255',
    'email' => 'required|email|max:255',
], [
    'name.required' => 'Your name is required.',
    'email.email' => 'Please enter a valid email address.',
]);

Handling File Uploads

If your form includes file uploads, don't forget to set the enctype="multipart/form-data" attribute on your form tag:

 <form action="/submit-form" method="POST" enctype="multipart/form-data">
    @csrf
    <input type="file" name="avatar">
</form>

In your controller, you can access the uploaded file like this:

 if ($request->hasFile('avatar')) {
    $path = $request->file('avatar')->store('avatar');
}

By default, Laravel stores files in the storage/app/ directory. If you want to make them publicly accessible, use the public disk:

 $path = $request->file('avatar')->store('avatar', 'public');

And then run:

 php artisan storage:link

To create a symlink so users can access the files via the web.

Basically, that's how you handle form submissions in Laravel. It's not too complicated, but there are a few important details—like CSRF tokens, validation, and file handling—that you shouldn't skip.

The above is the detailed content of How do I handle form submissions in Laravel?. For more information, please follow other related articles on the PHP Chinese website!