Laravel FilePond：文件上传的解决方案-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00596/article/details/147344166

Laravel FilePond：文件上传的解决方案

laravel-filepond Use FilePond the Laravel way. 项目地址: https://gitcode.com/gh_mirrors/lar/laravel-filepond

1. 项目介绍

Laravel FilePond 是一个为 Laravel 应用程序提供 FilePond 文件上传 JavaScript 库的后端支持的开源项目。它可以帮助开发者轻松管理上传的文件，并提供了以下特性：

单文件和多文件上传
支持断点续传的块上传
支持第三方存储
对临时文件的全局服务器端验证
在移动文件到永久位置前的控制器/请求级别的验证
定时清理过期临时文件和文件夹的 Artisan 命令
有效处理 FilePond 的 process、patch、head、revert 和 restore 端点
高效处理大文件

2. 项目快速启动

首先，确保您的 Laravel 项目环境准备就绪。

安装

使用 Composer 安装 Laravel FilePond：

composer require rahulhaque/laravel-filepond:^12.0

发布配置和迁移文件：

php artisan vendor:publish --provider="RahulHaque\Filepond\FilepondServiceProvider"

运行迁移：

php artisan migrate

配置

查看 config/filepond.php 了解所有可用的配置选项。根据需要修改配置。

集成 FilePond 库

在你的前端页面中，首先集成 FilePond 库。以下是一个简单的 HTML 表单示例，它包含了单文件和多文件上传字段：

<form action="{{ route('avatar') }}" method="post">
    @csrf
    <!-- 单文件上传 -->
    <input type="file" name="avatar" required/>
    <p class="help-block">{{ $errors->first('avatar') }}</p>
    <!-- 多文件上传 -->
    <input type="file" name="gallery[]" multiple required/>
    <p class="help-block">{{ $errors->first('gallery.*') }}</p>
    <button type="submit">提交</button>
</form>

<script>
    // 设置默认的 FilePond 选项
    FilePond.setOptions({
        server: {
            url: "{{ config('filepond.server.url') }}",
            headers: {
                'X-CSRF-TOKEN': "{{ csrf_token() }}",
            }
        }
    });

    // 创建 FilePond 实例
    FilePond.create(document.querySelector('input[name="avatar"]'));
    FilePond.create(document.querySelector('input[name="gallery[]"]'), {
        chunkUploads: true
    });
</script>

处理上传的文件

在控制器中处理提交的文件。以下是一个处理用户头像和图库更新的例子：

use Illuminate\Http\Request;
use RahulHaque\Filepond\Facades\Filepond;

class UserAvatarController extends Controller
{
    public function update(Request $request)
    {
        // 文件验证
        $this->validate($request, [
            'avatar' => 'required|image|max:2000',
            'gallery.*' => 'required|image|max:2000'
        ]);

        // 处理头像文件
        $avatarName = 'avatar-' . auth()->id();
        $fileInfo = Filepond::field($request->avatar)->moveTo('avatars/' . $avatarName);

        // 处理图库文件
        $galleryName = 'gallery-' . auth()->id();
        $fileInfos = Filepond::field($request->gallery)->moveTo('galleries/' . $galleryName);

        // 返回文件信息
        return response()->json($fileInfo);
    }
}