Laravel 10 File Upload Tutorial: Validation + Store in Database

Last Updated on by in Laravel
This is a step by step Laravel File Upload tutorial with example, and In this tutorial, we will learn how to upload files in Laravel with basic validation in MySQL database.This tutorial will cover Laravel file uploading concepts:

  • Laravel project Installation
  • Route creation and configuration
  • Blade file creation
  • Database migration in Laravel
  • Implement validation on file uploading component
  • File uploading status via displaying messages
  • Allow uploading only specific file types. e.g .csv, .txt, .xlx, .xls, .pdf with file size limitation max upto 2MB
  • Storing an uploaded file in the database

If you are a beginner in Laravel development, you must check out our detailed tutorial on Building Laravel CRUD Web Application.

File Upload in Laravel 10 Example

In this Laravel file upload example tutorial, we will generate two routes one for creating a form with getting method and another route for file uploading or post file upload data.

We develop a simple form using Bootstrap and its Form UI component.

It will allow us to choose a file that needs to be uploaded in the storage > public > uploads folder. We will also configure the database model and store the file path along with its name in the MySQL database.

Install Laravel Project

Open command-line tool and execute the following command to create a Laravel project from scratch.

composer create-project laravel/laravel --prefer-dist laravel-file-upload

Get into the freshly installed laravel project’s directory.

cd laravel-file-upload

Connect to Database

You can use MAMP or XAMPP as a local web server for uploading files to storage in laravel. Define a database name in MySQL and add the correct configuration in .env file.


If you are using MAMP local server in macOs; make sure to append UNIX_SOCKET and DB_SOCKET below database credentials in .env file.


Create File Model & Configure Migrations

Create a Model in laravel, It holds the data definition that interacts with the database.

php artisan make:model File -m

Next, open migration file for defining the table values in the database for storing the uploaded file’s information. Go to database/migrations/timestamp_create_files_table file and define the table values.


use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateFilesTable extends Migration
    public function up()
        Schema::create('files', function (Blueprint $table) {

    public function down()

Now, add the $fillable property in the File model. Open app/Models/File.php file and place the following code.


namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class File extends Model
    use HasFactory;
    protected $fillable = [

Now, you are all set to run the migration. You can also see the update in the mysql database.

php artisan migrate

Laravel File Upload Example

Create Routes in Laravel

Go to routes/web.php and create two routes. First, the route handles the form creation, and the second route stores the file in the MySQL database.


use Illuminate\Support\Facades\Route;
use App\Http\Controllers\FileUpload;

| Web Routes
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!

Route::get('/upload-file', [FileUpload::class, 'createForm']);

Route::post('/upload-file', [FileUpload::class, 'fileUpload'])->name('fileUpload');

Create File Upload Controller

Create a file uploading controller; we define the business logic for uploading and storing files in Laravel.

Execute the command to create the controller.

php artisan make:controller FileUpload

Open app/Http/Controllers/FileUpload.php file, and we need to define the two methods to handle the file upload.

The first method renders the view via FileUpload controller, and the fileUpload() method checks the validation, be it required, mime type or file size limitation.

This method also stores the file into storage/public/uploads folder and saves the file name and path in the database.


namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\File;

class FileUpload extends Controller
  public function createForm(){
    return view('file-upload');

  public function fileUpload(Request $req){
        'file' => 'required|mimes:csv,txt,xlx,xls,pdf|max:2048'

        $fileModel = new File;

        if($req->file()) {
            $fileName = time().'_'.$req->file->getClientOriginalName();
            $filePath = $req->file('file')->storeAs('uploads', $fileName, 'public');

            $fileModel->name = time().'_'.$req->file->getClientOriginalName();
            $fileModel->file_path = '/storage/' . $filePath;

            return back()
            ->with('success','File has been uploaded.')
            ->with('file', $fileName);


Create Blade File in Laravel

In this step, we will create a view along with the file uploading form.

Create resources\views\file-upload.blade.php file and place the following code inside of it.

<!doctype html>
<html lang="en">

    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <link rel="stylesheet" href="">

    <title>Laravel File Upload</title>
        .container {
            max-width: 500px;
        dl, ol, ul {
            margin: 0;
            padding: 0;
            list-style: none;


    <div class="container mt-5">
        <form action="{{route('fileUpload')}}" method="post" enctype="multipart/form-data">
          <h3 class="text-center mb-5">Upload File in Laravel</h3>
            @if ($message = Session::get('success'))
            <div class="alert alert-success">
                <strong>{{ $message }}</strong>

          @if (count($errors) > 0)
            <div class="alert alert-danger">
                    @foreach ($errors->all() as $error)
                      <li>{{ $error }}</li>

            <div class="custom-file">
                <input type="file" name="file" class="custom-file-input" id="chooseFile">
                <label class="custom-file-label" for="chooseFile">Select file</label>

            <button type="submit" name="submit" class="btn btn-primary btn-block mt-4">
                Upload Files


This code is responsible for showing file uploading form and also display the message based on the status.

Start Laravel Application

To check the demo, execute the following command.

php artisan serve

Check the app on the following Url.

Laravel File Upload Tutorial

Finally, we have completed the Laravel File uploading tutorial.

Digamber - Author

Hi, I'm Digamber Singh, a New Delhi-based full-stack developer, tech author, and open-source contributor with 10+ years' experience in HTML, CSS, JavaScript, PHP, and WordPress.