在 laravel 8 中，`buildtemporaryurlsusing` 是 `storage` 门面的静态方法，需通过 `illuminate\support\facades\storage` 正确引入；若误用底层 flysystem 实例或未导入门面，会触发“method does not exist”错误。
要在 Laravel 8.22（及兼容版本）中为本地磁盘（如 'local'）支持临时签名 URL（例如用于受控文件下载），不能直接调用 Storage::disk('local')->buildTemporaryUrlsUsing(...) —— 因为该方法属于 Storage 门面（Facade）的静态扩展机制，而非底层 League\Flysystem\Filesystem 实例的方法。
✅ 正确做法是在 AppServiceProvider::boot() 中使用 Storage::buildTemporaryUrlsUsing()（无 ->disk() 链式调用），并确保已正确导入门面：
// app/Providers/AppServiceProvider.php
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\URL;
public function boot()
{
// ✅ 全局注册临时 URL 构造逻辑（适用于所有支持的磁盘）
Storage::buildTemporaryUrlsUsing(function ($diskName, $path, $expiration, $options) {
// 仅对 'local' 磁盘启用自定义临时 URL；S3 磁盘可保持原生行为（自动支持）
if ($diskName === 'local') {
return URL::temporarySignedRoute(
'files.download',
$expiration,
array_merge($options, ['path' => $path])
);
}
// 其他磁盘（如 's3'）返回 null，交由 Laravel 默认逻辑处理
return null;
});
}⚠️ 注意事项：
- buildTemporaryUrlsUsing 是 Storage 门面的静态方法，必须通过 Storage:: 调用，不可链式调用 ->disk()->...；
- 必须在 use 语句中显式引入 Illuminate\Support\Facades\Storage，否则 PHP 会尝试解析为全局类或报命名空间错误；
- 闭包接收参数顺序为 ($diskName, $path, $expiration, $options)（Laravel 8.22+ 文档已明确），而非旧版 $path, $expiration, $options；
- 返回 null 表示跳过自定义逻辑，交由底层驱动（如 S3）原生生成临时 URL；
- 对应路由 files.download 需已定义且使用 signed 中间件验证：
// routes/web.php
Route::get('/download/{path}', [FileController::class, 'download'])
->name('files.download')
->middleware('signed');? 小结：该机制本质是 Laravel 文件系统对“不原生支持临时 URL 的磁盘”提供的扩展钩子。只要正确注册门面、匹配参数签名、按磁盘名条件分发，即可安全统一处理本地与云存储的临时访问逻辑。
