Laravel中注册Firebase Storage为文件系统的适配问题求助

1. 安装兼容的存储适配器包 #

放弃不兼容的superbalist/laravel-google-cloud-storage，改用官方维护的league/flysystem-google-cloud-storage，它完美支持Laravel 9及以上版本：

composer require league/flysystem-google-cloud-storage "^3.0"

2. 注册Firebase Storage文件系统驱动 #

在App\Providers\AppServiceProvider的boot方法中，使用kreait/laravel-firebase提供的客户端结合官方适配器完成扩展：

use Illuminate\Support\Facades\Storage;
use League\Flysystem\Filesystem;
use League\Flysystem\GoogleCloudStorage\GoogleCloudStorageAdapter;
use Illuminate\Filesystem\FilesystemAdapter;
use Kreait\Laravel\Facades\Firebase;

public function boot()
{
    Storage::extend('firebase', function ($app, array $config) {
        // 通过kreait包获取已配置的Firebase Storage实例
        $storage = Firebase::storage();
        $bucket = $storage->getBucket($config['bucket']);

        // 使用官方适配器替代废弃的GoogleStorageAdapter
        $adapter = new GoogleCloudStorageAdapter($bucket, $config['path_prefix'] ?? '');

        return new FilesystemAdapter(
            new Filesystem($adapter, $config),
            $adapter,
            $config
        );
    });
}

3. 配置文件系统磁盘 #

在config/filesystems.php的disks数组中添加Firebase存储配置：

'firebase' => [
    'driver' => 'firebase',
    'project_id' => env('FIREBASE_PROJECT_ID'),
    'bucket' => env('FIREBASE_STORAGE_BUCKET'),
    'path_prefix' => env('FIREBASE_STORAGE_PATH_PREFIX', ''), // 可选：文件存储前缀路径
    'key_file' => env('FIREBASE_SERVICE_ACCOUNT_JSON'), // 对应kreait包的服务账号JSON路径
],

4. 基础使用示例 #

// 上传文件
Storage::disk('firebase')->put('documents/report.pdf', file_get_contents('/local/path/report.pdf'));

// 获取文件URL
$url = Storage::disk('firebase')->url('documents/report.pdf');

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