17370845950

laravel 9 升级至 flysystem 3 后，`storage::disk('s3')->getdriver()->getadapter()->getclient()` 方式失效；本文详解兼容 flysystem 3 的 s3client 获取方案，包括临时宏观扩展方案及官方原生支持的演进路径。

在 Laravel 9 中，由于底层存储抽象层全面迁移到 Flysystem 3，原有的 getAdapter() 方法已被移除——Storage::disk('s3') 返回的是 Illuminate\Filesystem\FilesystemAdapter 实例（封装了 Flysystem Filesystem），而后者不再提供 getAdapter() 方法，因此调用链 ->getDriver()->getAdapter()->getClient() 会直接抛出 Call to undefined method League\Flysystem\Filesystem::getAdapter() 异常。

幸运的是，Laravel 的 FilesystemAdapter 及其子类（如 AwsS3V3Adapter）均继承自 Macroable，支持运行时动态注入方法。针对当前缺失的 getClient() 访问能力，最简洁可靠的临时解决方案是在服务提供者中注册一个宏（macro）：

// app/Providers/AppServiceProvider.php
use Illuminate\Filesystem\AwsS3V3Adapter;
use Illuminate\Support\Facades\Storage;

public function boot()
{
    // ✅ 为 AwsS3V3Adapter 注册 getClient 宏（仅适用于 's3' 磁盘）
    AwsS3V3Adapter::macro('getClient', fn() 
=> $this->client);
}

注册后，即可像 Laravel 8 一样直接调用：

use Illuminate\Support\Facades\Storage;

$client = Storage::disk('s3')->getClient(); // ✅ 返回 Aws\S3\S3Client 实例

$bucket = config('filesystems.disks.s3.bucket');
$result = $client->createMultipartUpload([
    'Bucket' => $bucket,
    'Key' => $key,
    'ContentType' => 'image/jpeg',
    'ContentDisposition' => 'inline',
]);

return response()->json([
    'uploadId' => $result['UploadId'],
    'key' => $result['Key'],
]);

⚠️ 注意事项：

• 该宏仅对 AwsS3V3Adapter 生效（即使用 s3 驱动的磁盘），不适用于其他驱动（如 local、ftp）；
• 若项目中存在多个 S3 磁盘（如 s3-backup），需确保所有相关磁盘均使用 AwsS3V3Adapter，宏会自动生效；
• Laravel 框架已于 v9.5.0（2025年2月22日发布）原生支持 getClient() 方法，升级至该版本或更高后，可直接删除宏定义，无需任何修改；
• 建议在 AppServiceProvider::boot() 中注册宏，避免在请求生命周期早期因类未加载导致异常。

✅ 验证是否生效：可在 Tinker 中快速测试：

php artisan tinker
>>> Storage::disk('s3')->getClient() instanceof \Aws\S3\S3Client
=> true

综上，通过宏扩展方式，你可在 Laravel 9 中无缝复用原有 S3 多部分上传逻辑；待升级至 Laravel ≥9.5.0 后，该方案将自然过渡为官方标准用法，实现平滑演进与长期维护性兼顾。