😁👏 File Upload: Validation, Store in Database, Storage link, Tạo lệnh php artisan bằng route(Phần 1)

https://www.positronx.io/laravel-file-upload-with-validation/

Bước 1: Upload file vào thư mục storage/uploads

C:\xampp8\htdocs\plugindev\database\migrations\2022_12_29_091725_create_files_table.php

<?php
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) {
      $table->id();
      $table->string('name')->nullable();
      $table->string('file_path')->nullable();
      $table->timestamps();
    });
  }
  public function down()
  {
    Schema::dropIfExists('files');
  }
}

C:\xampp8\htdocs\plugindev\app\Models\File.php

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class File extends Model
{
  use HasFactory;
  protected $fillable = [
    'name',
    'file_path'
  ];
}

C:\xampp8\htdocs\plugindev\resources\views\file-upload.blade.php

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/css/bootstrap.min.css">
  <title>Laravel File Upload</title>
  <style>
    .container {
      max-width: 500px;
    }
    dl,
    ol,
    ul {
      margin: 0;
      padding: 0;
      list-style: none;
    }
  </style>
</head>
<body>
  <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>
      @csrf
      @if ($message = Session::get('success'))
      <div class="alert alert-success">
        <strong>{{ $message }}</strong>
      </div>
      @endif
      @if (count($errors) > 0)
      <div class="alert alert-danger">
        <ul>
          @foreach ($errors->all() as $error)
          <li>{{ $error }}</li>
          @endforeach
        </ul>
      </div>
      @endif
      <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>
      </div>
      <button type="submit" name="submit" class="btn btn-primary btn-block mt-4">
        Upload Files
      </button>
    </form>
  </div>
</body>
</html>

C:\xampp8\htdocs\plugindev\routes\web.php

<?php
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('/', function () {
    return view('welcome');
});
Route::get('/upload-file', [FileUpload::class, 'createForm']);
Route::post('/upload-file', [FileUpload::class, 'fileUpload'])->name('fileUpload');
Route::get('/use-file', [FileUpload::class, 'use_file']);

C:\xampp8\htdocs\plugindev\app\Http\Controllers\FileUpload.php

<?php
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)
  {
    $req->validate([
      'file' => 'required|mimes:csv,txt,xlx,xls,pdf,jpg,png|max:20048'
    ]);
    $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;
      $fileModel->save();
      return back()
        ->with('success', 'File has been uploaded.')
        ->with('file', $fileName);
    }
  }
  public function use_file()
  {
    $files = File::all();
    return view('use-file')->with(compact('files'));
  }
}

C:\xampp8\htdocs\plugindev\database\migrations\2022_12_29_091725_create_files_table.php

<?php
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) {
      $table->id();
      $table->string('name')->nullable();
      $table->string('file_path')->nullable();
      $table->timestamps();
    });
  }
  public function down()
  {
    Schema::dropIfExists('files');
  }
}

Kết quả sau khi upload file trên database như này :)

Bước 2: Tạo Storage link storage symbolic link for production or sub domain

Thật tuyệt vời giờ trong C:\xampp8\htdocs\plugindev\public\storage\uploads nó cũng chứa các file giống với

php artisan storage:link

C:\xampp8\htdocs\plugindev\storage\app\public\uploads

Nhưng thật ra chúng liên kiên với storage, storeage lại liên kết với folder cố định khác nữa do đó khi upload trên server nó không bị mất ảnh.

Bước 3: Sử dụng thành quả hiển thị ra ảnh :)

C:\xampp8\htdocs\plugindev\resources\views\use-file.blade.php

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/css/bootstrap.min.css">
  <title>Laravel File Upload</title>
  <style>
    .container {
      max-width: 500px;
    }
    dl,
    ol,
    ul {
      margin: 0;
      padding: 0;
      list-style: none;
    }
  </style>
</head>
<body>
  <div class="container mt-5">
    @foreach ($files as $file)
      <div class="row mb-2">
        <img class="img-fluid" src="{{ $file->file_path }}" alt="Text Placeholder">
      </div>
    @endforeach
  </div>
</body>
</html>

Bước 4: Tạo lệnh php artisan storage:link bằng route

Route::get('/foo', function () {
  Artisan::call('storage:link');
});

Laravel 9 File Upload Tutorial: Validation + Store in 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.

Table of Contents

File Upload in Laravel 9 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

BashCopy

Get into the freshly installed laravel project’s directory.

cd laravel-file-upload

BashCopy

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.

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=

PL/SQLCopy

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

UNIX_SOCKET=/Applications/MAMP/tmp/mysql/mysql.sock
DB_SOCKET=/Applications/MAMP/tmp/mysql/mysql.sock

BashCopy

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

BashCopy

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.

<?php
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) {
            $table->id();
            $table->string('name')->nullable();
            $table->string('file_path')->nullable();
            $table->timestamps();
        });
    }
    public function down()
    {
        Schema::dropIfExists('files');
    }
}

PHPCopy

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

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class File extends Model
{
    use HasFactory;
    protected $fillable = [
        'name',
        'file_path'
    ];
}

PHPCopy

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

php artisan migrate

BashCopy

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.

<?php
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');

PHPCopy

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

BashCopy

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.

<?php
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){
        $req->validate([
        '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;
            $fileModel->save();
            return back()
            ->with('success','File has been uploaded.')
            ->with('file', $fileName);
        }
   }
}

PHPCopy

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">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/css/bootstrap.min.css">
    <title>Laravel File Upload</title>
    <style>
        .container {
            max-width: 500px;
        }
        dl, ol, ul {
            margin: 0;
            padding: 0;
            list-style: none;
        }
    </style>
</head>
<body>
    <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>
            @csrf
            @if ($message = Session::get('success'))
            <div class="alert alert-success">
                <strong>{{ $message }}</strong>
            </div>
          @endif
          @if (count($errors) > 0)
            <div class="alert alert-danger">
                <ul>
                    @foreach ($errors->all() as $error)
                      <li>{{ $error }}</li>
                    @endforeach
                </ul>
            </div>
          @endif
            <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>
            </div>
            <button type="submit" name="submit" class="btn btn-primary btn-block mt-4">
                Upload Files
            </button>
        </form>
    </div>
</body>
</html>