File Upload trong Laravel – [Phần 8] Quản lý ảnh nâng cao với Spatie Media Library

composer require "spatie/laravel-medialibrary"Code language: JavaScript (javascript)

php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-config"
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-config"Code language: Nginx (nginx)

php artisan migrateCode language: Nginx (nginx)

<?php

return [

    /*
     * The disk on which to store added files and derived images by default. Choose
     * one or more of the disks you've configured in config/filesystems.php.
     */
    'disk_name' => env('MEDIA_DISK', 'public'),
Code language: HTML, XML (xml)

MEDIA_DISK=minio

php artisan make:migration remove_filename_and_thumbnail_from_uploads_table --table=uploadsCode language: Nginx (nginx)

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::table('uploads', function (Blueprint $table) {
            // Check if the columns exist before trying to drop them (optional, but good practice)
            if (Schema::hasColumn('uploads', 'filename')) {
                $table->dropColumn('filename');
            }
            if (Schema::hasColumn('uploads', 'thumbnail')) {
                $table->dropColumn('thumbnail');
            }
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::table('uploads', function (Blueprint $table) {
            // Re-add the columns if rolling back.
            // Adjust the type if they were different (e.g., text)
            // Making them nullable as they might not have data if rolled back after new entries.
            $table->string('filename')->nullable();
            $table->string('thumbnail')->nullable();
        });
    }
};
Code language: HTML, XML (xml)

php artisan migrateCode language: Nginx (nginx)

    protected $fillable = [
        'original_filename',
    ];Code language: PHP (php)

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Storage;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class Upload extends Model implements HasMedia
{
    use InteractsWithMedia; 
    
Code language: HTML, XML (xml)

use Spatie\MediaLibrary\MediaCollections\Models\Media;

    public function registerMediaConversions(?Media $media = null): void
    {
        $this->addMediaConversion('thumbnail')
            ->width(100)
            ->height(100)
            ->performOnCollections('images'); //  images là tên collection lưu ảnh
    }Code language: PHP (php)

php artisan media-library:regenerateCode language: CSS (css)

<?php

namespace App\Http\Controllers;

use App\Models\Upload;
use Illuminate\Http\Request;Code language: HTML, XML (xml)

    public function store(Request $request)
    {
        // Kiểm tra request có chứa file không? và có dáp ứng các yêu cầu không
        $request->validate([
            'files' => 'required|array', // Tên input là 'files[]' trong HTML
            'files.*' => 'required|image|mimes:jpg,jpeg,png|max:2048', // max = 2MB mỗi file
        ]);

        // Tạo biến mới để lưu đường dẫn và tên file gốc
        $originalFilenames = []; // Array lưu tên gốc của các file
        $uploadedFiles = $request->file('files'); // Lấy array các đối tượng file đã upload
        $numberOfFiles = count($uploadedFiles); // Đếm số lượng file đã upload

        // Lặp qua từng file trong array $uploadedFiles
        foreach ($uploadedFiles as $file) {

            // Lấy tên file gốc từ client
            $originalFilename = $file->getClientOriginalName();
            $originalFilenames[] = $originalFilename; // Thêm tên gốc vào array

            // 3. Tạo bản ghi trong database cho model Upload:
            //    Lưu ý: Chúng ta chỉ cần lưu 'original_filename'.
            //    Các thông tin về đường dẫn file gốc và thumbnail sẽ do media-library quản lý.
            $uploadEntry = Upload::create([
                'original_filename' => $originalFilename,
            ]);

            // 4. Đây là phần quan trọng nhất - Thêm file vào Media Library:
            $uploadEntry->addMedia($file) // Thêm file vào Media Library
                        ->toMediaCollection('images'); // Thêm file vào collection 'images'
        }

        // Chuyển hướng về trang trước đó
        return back()->with('success', 'You have successfully uploaded ' . $numberOfFiles . ' files')
            // Gửi kèm array các tên file gốc vào session flash data với key 'original_filenames'
            ->with('original_filenames', $originalFilenames);
    }Code language: PHP (php)

    public function destroy(Upload $upload)
    {
        // Spatie Media Library sẽ tự động xoá các file liên quan (file gốc và các file chuyển đổi)
        // khỏi disk khi model bị xoá.
        $upload->delete();

        // Chuyển hướng người dùng về trang trước đó với thông báo thành công
        return back()->with('success', 'You have successfully deleted ' . $upload->original_filename);
    }Code language: PHP (php)

php artisan queue:workCode language: CSS (css)

    public function registerMediaConversions(?Media $media = null): void
    {
        $this->addMediaConversion('thumbnail')
            ->width(100)
            ->height(100)
            ->nonQueued()
            ->performOnCollections('images'); // images là tên collection lưu ảnh
    }Code language: PHP (php)

queue_conversions_by_default=falseCode language: JavaScript (javascript)

    public function getUrlAttribute(): string
    {

        $mediaItem = $this->getFirstMedia('images');
        if ($mediaItem) {
            // Tạo URL tạm thời cho file gốc.
            return $mediaItem->getTemporaryUrl(now()->addMinutes(5));
        }
        return ''; // Trả về chuỗi rỗng hoặc một URL placeholder nếu không tìm thấy file
    }Code language: PHP (php)

    public function getThumbnailUrlAttribute(): string
    {
        $mediaItem = $this->getFirstMedia('images');

        if ($mediaItem) {
            // Tạo URL tạm thời cho file thumbnail (conversion)
            return $mediaItem->getTemporaryUrl(now()->addMinutes(5), 'thumbnail');
        }
        return ''; // Trả về chuỗi rỗng hoặc một URL placeholder nếu không tìm thấy thumbnail
    }Code language: PHP (php)