Laravel Filament FileUpload组件如何通过外部URL显示默认文件？

要实现自定义存储逻辑（API/FTP多服务器存储）并让Filament的FileUpload组件正常显示外部URL预览，你需要调整组件的两个核心配置：接管存储逻辑、自定义预览URL。

1. 核心代码调整 #

FileUpload::make('image')
    ->image()
    ->imageEditor()
    ->circleCropper()
    ->imageResizeTargetWidth(512)
    ->imageResizeTargetHeight(512)
    ->imageResizeMode('cover')
    ->imageCropAspectRatio('1:1')
    ->imagePreviewHeight('100')
    // 接管存储逻辑，禁止Filament自动存本地
    ->storeUsing(function (UploadedFile $file) {
        // 在这里实现你的API/FTP上传逻辑
        // 示例：调用自定义方法上传到外部服务器，返回外部URL
        $externalUrl = $this->uploadToExternalServer($file);
        
        // 返回要存入数据库的内容（比如外部URL）
        return $externalUrl;
    })
    // 自定义预览URL，支持显示外部地址
    ->getPreviewUrlUsing(function ($state) {
        // $state为数据库中存储的外部URL，直接返回即可
        return $state;
    })
    // 设置默认图片（创建表单时显示）
    ->default('https://picsum.photos/200/300')
    // 确保预览功能开启（默认已开启，这里明确标注）
    ->previewable()
    // 可选：自定义删除逻辑（删除时调用API/FTP删除外部文件）
    ->deleteUsing(function ($state) {
        $this->deleteFromExternalServer($state);
    });

2. 关键配置说明 #

• storeUsing()：彻底接管文件存储流程，Filament不会再自动将文件保存到本地磁盘。你可以在闭包内实现多服务器的API/FTP上传逻辑，最后返回需要存入数据库的标识（比如外部文件URL）。
• getPreviewUrlUsing()：针对编辑状态的文件，组件会通过这个方法获取预览地址，直接返回数据库中存储的外部URL即可解决预览不显示的问题。
• default()：给创建表单设置默认图片URL，配合getPreviewUrlUsing就能正常显示默认预览。
• deleteUsing()：可选配置，当用户删除文件时，调用你的API/FTP逻辑删除外部服务器上的文件。

内容的提问来源于stack exchange，提问作者Afshar