Spatie Laravel Medialibrary兼容GCS问题：调用makeDirectory报错求助

问题根源 #

你遇到的Call to undefined method League\Flysystem\Filesystem::makeDirectory()错误，本质是Laravel Medialibrary版本与Flysystem版本不兼容：旧版Medialibrary依赖Flysystem 2.x及以下版本，使用makeDirectory()方法；而Flysystem 3.x+已将该方法重命名为createDirectory()，你当前使用的GCS适配库基于Flysystem 3.x，导致方法调用不匹配。

可行解决方案 #

1. 升级Laravel Medialibrary到兼容Flysystem 3.x的版本 #

Spatie的Laravel Medialibrary从v10.0版本开始全面支持Flysystem 3.x，执行以下命令升级：

composer require spatie/laravel-medialibrary:^10.0

注意：Medialibrary版本需匹配你的Laravel版本：v10对应Laravel 9.x+，v11对应Laravel 10.x+，根据实际情况选择。

2. 安装官方GCS Flysystem适配器 #

使用League官方维护的Google Cloud Storage适配器，安装命令：

composer require league/flysystem-google-cloud-storage

3. 配置GCS磁盘 #

在config/filesystems.php中添加GCS磁盘配置：

'disks' => [
    // ... 其他磁盘配置
    'gcs' => [
        'driver' => 'gcs',
        'project_id' => env('GOOGLE_CLOUD_PROJECT_ID'),
        'key_file' => env('GOOGLE_CLOUD_KEY_FILE'), // 可填密钥文件路径，或直接传入数组格式的密钥内容
        'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET'),
        'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', ''), // 可选，存储路径前缀
        'visibility' => 'public', // 设为'private'则文件仅私有访问
    ],
],

4. 配置Medialibrary使用GCS磁盘 #

• 全局配置：修改config/medialibrary.php中的disk参数为gcs：

  'disk' => env('MEDIA_DISK', 'gcs'),
  

• 单模型配置：在对应模型的registerMediaCollections方法中指定磁盘：

  public function registerMediaCollections(): void
  {
      $this->addMediaCollection('images')->useDisk('gcs');
  }
  

额外注意事项 #

• 确保Google Cloud服务账号密钥拥有目标存储桶的存储对象创建、读取权限；
• 升级后若出现其他兼容性问题，可参考Medialibrary官方文档的升级指南调整代码。

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