如何使用 spatie/laravel-google-cloud-storage

如何使用 spatie/laravel-google-cloud-storage

laravel-google-cloud-storageGoogle Cloud Storage filesystem driver for Laravel项目地址:https://gitcode.com/gh_mirrors/lar/laravel-google-cloud-storage

项目介绍

spatie/laravel-google-cloud-storage 是一个为 Laravel 框架设计的扩展包，它提供了一种简便的方式来集成 Google Cloud Storage 服务。此扩展基于 Flysystem v3 和谷歌云存储的自定义驱动，支持 Laravel 9 及以上版本，使得开发者能够轻松地在 Laravel 应用中管理存储在 Google Cloud 的文件。

项目快速启动

安装

首先，通过 Composer 添加该扩展包到你的 Laravel 项目：

composer require spatie/laravel-google-cloud-storage

配置

安装之后，你需要配置 Laravel 文件系统以使用新的 GCS 驱动。这涉及到创建或编辑 config/filesystems.php 文件，并添加以下配置：

'disks' => [
    // ...
    'gcs' => [
        'driver' => 'gcs',
        'project_id' => env('GCS_PROJECT_ID'),
        'key_file' => storage_path('app/gcs-keyfile.json'), // 路径指向下载的JSON密钥文件
        'bucket' => env('GCS_BUCKET'),
        'path_prefix' => '', // 根据需求设置路径前缀
    ],
],

确保将你的 Google Cloud Service Account 的 JSON 密钥文件安全地存储，并设置好相应的环境变量。

环境变量

在 .env 文件中加入相应的环境变量：

GCS_PROJECT_ID=your_project_id_here
GCS_KEY_FILE=path/to/your/keyfile.json
GCS_BUCKET=your_bucket_name

应用案例和最佳实践

当你成功配置后，可以像使用其他 Laravel 存储驱动一样使用 GCS。例如，上传文件：

use Illuminate\Support\Facades\Storage;

if ($file = $request->file('image')) {
    $filePath = $file->storeAs('uploads', $file->getClientOriginalName(), 'gcs');
}

最佳实践中，你应该：

• 安全性：始终将密钥文件放在私有目录，并从 .gitignore 中排除。
• 访问控制：利用 Laravel 的中间件来控制对上传文件的访问。
• 优化资源：考虑使用 Google Cloud Storage 提供的特性，如生命周期管理来自动压缩或删除旧文件。

典型生态项目

虽然本项目自身是生态的一部分，但结合其他Laravel扩展如laravel-medialibrary，可以实现更高级的媒体管理功能，比如自动处理图像尺寸、视频转码等，进一步增强与Google Cloud Storage的集成能力。

通过这样的整合，不仅简化了云存储的日常操作，也为 Laravel 应用提供了强大的数据存储解决方案，提升了应用的可扩展性和稳定性。

---

此文档提供了一个基础框架，实际应用时可能需依据具体场景调整配置及实践细节。

laravel-google-cloud-storageGoogle Cloud Storage filesystem driver for Laravel项目地址:https://gitcode.com/gh_mirrors/lar/laravel-google-cloud-storage