README

一个用于处理来自多个来源的文件上传的Laravel包，如文件对象、URL或base64编码的数据

当前功能

• 支持从多个来源上传文件，如文件对象、URL或base64编码的数据
• 文件验证（基于扩展名和大小）
• 支持处理多个文件

即将推出的功能

• 文件压缩
• 支持文件删除

要求

建议使用 PHP版本7.2+ 和 Laravel框架版本5.5+ 安装此包

安装

composer require oldravian/multi-source-file-uploader

配置

将配置复制到您的项目中

php artisan vendor:publish --provider="OldRavian\FileUploader\FileUploaderServiceProvider"

执行上述命令后，包配置将发布到 config/old-ravian-file-uploader.php

使用方法

首先，您需要使用 FileUploaderFactory 初始化特定的 FileUploader 实例

$file_uploader_factory = new \OldRavian\FileUploader\Factories\FileUploaderFactory();
$file_uploader = $file_uploader_factory->build(here you need to provide the file source name, it could be "object", "url" or "base64");

从对象上传文件

在您的控制器方法中

public function uploadFile(Request $request)
{
  $uploadSettings = ["directory"=>"mention directory", "disk"=>"mention disk", "maxFileSize"=>"mention size in bytes", "allowedExtensions"=>[mention extensions]];
  $file_uploader_factory = new \OldRavian\FileUploader\Factories\FileUploaderFactory();
  $file_uploader = $file_uploader_factory->build("object");
   
  //first parameter should be an instance of \Illuminate\Http\UploadedFile
  //second parameter is optional, if you leave that parameter then default settings will be used
  $data = $file_uploader->upload($request->file, $uploadSettings); //it will return an array
}

$uploadSettings 是一个关联数组，包含以下可能的键

• directory：包含您的上传文件的根目录
• disk：文件上传的存储磁盘。有关更多详细信息，请参阅Laravel官方文档，例如：public、s3
• maxFileSize（以字节为单位）：上传文件的最大大小
• allowedExtensions：可接受文件扩展名的数组，例如：['jpg', 'png', 'pdf']

后端默认设置如下

- 'directory': 'media'
- 'disk': 'public'
- 'maxFileSize':  50 MB
- 'allowedExtensions': 'png','jpg','jpeg','mp4','doc','docx','ppt','pptx','xls','xlsx','txt','pdf'

您可以使用以下环境变量在 .env 中更改这些默认设置

• OLDRAVIAN_File_UPLOADER_DEFAULT_DISK
• OLDRAVIAN_File_UPLOADER_DEFAULT_DIRECTORY
• OLDRAVIAN_File_UPLOADER_DEFAULT_MAX_FILE_SIZE（以字节为单位）

如果上传成功，$file_uploader->upload($request->file, $uploadSettings) 将返回以下数据以进一步持久化到数据库

[
    'filename' => 'uploaded file name',
    'path' => 'path to file location relative to the disk storage',
    'url' => 'public url to access the file in browser'
]

如果上传的文件无效，则将返回 false 并将错误消息设置为 $file_uploader->uploadError

从URL上传文件

$file_uploader_factory = new \OldRavian\FileUploader\Factories\FileUploaderFactory();
$file_uploader = $file_uploader_factory->build("url");

//first parameter should be a string url
//second parameter is optional, if you leave that parameter then default settings will be used
$data = $file_uploader->upload($request->url, $uploadSettings);

从base64编码的数据上传文件

$file_uploader_factory = new \OldRavian\FileUploader\Factories\FileUploaderFactory();
$file_uploader = $file_uploader_factory->build("base64");

//first parameter should be a string (base64 encoded string)
//second parameter is optional, if you leave that parameter then default settings will be used
$data = $file_uploader->upload($request->base64_str, $uploadSettings);

处理多个文件上传

$file_uploader_factory = new \OldRavian\FileUploader\Factories\FileUploaderFactory();
$file_uploader = $file_uploader_factory->build("object or url or base64");

$urls_array = ["first file url", "second file url", "third file url"];
//first parameter should be an array (it could be an array of objects or urls or base64 encoded strings array based on what you mentioned in the above line)
//second parameter is optional, if you leave that parameter then default settings will be used
$data_array = $file_uploader->uploadMany($urls_array, $uploadSettings); //$data_array is a 2d array