软通/fine-uploader

Laravel 对 fineUploader.js 包的封装

1.1 2020-03-23 10:45 UTC

This package is auto-updated.

Last update: 2024-09-29 05:36:06 UTC


README

运行命令

composer require xsoft/fine-uploader
php artisan fineUploader:install
php artisan config:cache

使用方法

1. 在视图中包含
    @include('xsoft.fineUploader.combined')  

请记得调整 xsoft/fineUploader/combined.blade.php 文件以适应您的布局。

2. 在您希望上传器显示的位置添加 div
<div id="my-fine-uploader"></div>
3. 在您的 div 上调用函数
 $('#my-fine-uploader').customFineUploader();

选项

大部分选项与 FineUploader.js 文档 中指定的选项相同。

 $('#my-fine-uploader').customFineUploader({
    'multiple' : true,
    'directory' : 'my_directory',
    'inputId' : 'my-input-id',
    'debug' : 1,
    'onCompleteCallback' : myJsFunction,
    'allowedExtensions' : ['jpg','png']
 });
 

- multiple

指定输入是否应接受多个文件。默认:false

- allowedExtensions

允许的扩展名数组。默认:[] - 接受所有

- directory

指定存储中的目录。默认目录为 "fineUploader"

- template

指定模板 ID。

- inputId

指定是否在成功上传后向输入注入文件名。

- partSize

指定每次发送的块大小。默认值可以在 config/fineUploader.php 中管理

- debug

在控制台中打开或关闭 fineUploader.js 调试。

- onCompleteCallback

- onCancelCallback

- onUploadCallback

- onDeleteCallback

- onDeleteCompleteCallback

配置

您可以在 config\fineUploader.php 文件中配置 fineUploader 选项,或者通过将它们添加到项目的 .env 文件中来实现。

FINEUPLOADER_CHUNKING_PARTSIZE=2000000
FINEUPLOADER_DEBUG=0
FINEUPLOADER_TMP_LIFESPAN=12

路由

Route::prefix('fineUploader')->name('fineUploader.')->group(function () {
    Route::post('/upload', 'Xsoft\FineUploaderController@upload')->name('upload');
    Route::delete('/delete/{id?}', 'Xsoft\FineUploaderController@delete')->name('delete');
});

为了在 fineUploader 路由上添加身份验证,您可以将这些路由添加到项目的 web.php 路由文件中,并自行确保安全。