evgen-dev/plupload-for-laravel

Laravel/Plupload - 处理大文件上传

v0.1.2 2023-06-15 09:18 UTC

This package is auto-updated.

Last update: 2024-09-15 12:09:30 UTC


README

Laravel plupload 支持。

处理分块上传。

安装

使用 composer 安装

composer require evgen-dev/plupload-for-laravel

将提供者添加到 config/app.php

'providers' => [
    EvgenDev\LaravelPlupload\LaravelPluploadServiceProvider::class,
]

如果您想使用简短的命名空间

'aliases' => array(
    'Plupload' => EvgenDev\LaravelPlupload\Facades\Plupload::class,
),

使用

1. 如果不存在,创建 resources/lang/en/validation.php 文件并添加以下行

return [
    'invalid_file_extension' => 'It is forbidden to upload .:extension files',

    'max' => [
        'file' => 'The :attribute field must not be greater than :max :units.',
    ]
];

2. 添加上传路由

无限制的基本用法

Route::post('/upload', function(){
    return Plupload::receive('file', function($file){
        $file->move(storage_path() . '/plupload/', $file->getClientOriginalName());
        return true;
    });

});

限制上传文件大小

use EvgenDev\LaravelPlupload\Filters\Filesize;

Route::post('/upload', function(){
    return Plupload::sizelimit(3, Filesize::FILE_SIZE_UNITS_MB)
    ->receive('file', function($file){
        $file->move(storage_path() . '/plupload/', $file->getClientOriginalName());
        return true;
    });
});

限制上传文件扩展名

Route::post('/upload', function()
{
    return Plupload::extensions(['jpg', 'png', 'gif'])->receive('file', function($file){
        $file->move(storage_path() . '/plupload/', $file->getClientOriginalName());
        return true;
    });

});

限制上传文件大小和扩展名

use \EvgenDev\LaravelPlupload\Filters\Filesize;

Route::post('/upload', function()
{
    return Plupload::sizelimit(5, Filesize::FILE_SIZE_UNITS_MB)
    ->extensions(['jpg', 'png', 'gif'])
    ->receive('file', function($file){
        $file->move(storage_path() . '/plupload/', $file->getClientOriginalName());
        return 'ready';
    });
});

在控制器中使用

use EvgenDev\LaravelPlupload\Facades\Plupload;

public function upload(Request $request){
    return Plupload::sizelimit(5, Filesize::FILE_SIZE_UNITS_MB)
        ->extensions(['txt'])
        ->receive('file', function($file){
            $filename = uniqid().'.'.$file->extension();
            $file->move(storage_path() . '/plupload/', $filename);
            return ['success' => true, 'filename' => $filename];
        });
}

3. csrf-token 验证

有两种方法。

1. 传递令牌

在您的 blade 文件中添加

<meta name="csrf-token" content="{{ csrf_token() }}">

在您的 Plupload 初始化 JS 文件中添加

headers: {
    'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
},

不要忘记在每个请求后刷新令牌。

2. 禁用令牌验证

添加到您的路由规则中

->withoutMiddleware([\App\Http\Middleware\VerifyCsrfToken::class]);

它应该看起来像这样

Route::post('/upload', function()
{
    return Plupload::receive('file', function($file){
        $file->move(storage_path() . '/plupload/', $file->getClientOriginalName());
        return true;
    });

})->withoutMiddleware([\App\Http\Middleware\VerifyCsrfToken::class]);

4. 在文件大小或扩展名错误后防止分块上传

添加到您的 JS 文件事件处理中

uploader.bind('ChunkUploaded', function(up, file, response) {
        response = jQuery.parseJSON(response.response);
        if(response.error && (response.error.code == 413 || response.error.code == 415)){
            alert(response.error.message);
            file.destroy();
        }
        up.refresh();
    });

享受吧!