如何在Laravel中轻松集成GoogleCloudStorage？使用Composer解决文件存储难题

Storage

superbalist/laravel-google-cloud-storage

flysystem-google-storage

<pre class="brush:php;toolbar:false;">composer require superbalist/laravel-google-cloud-storage

config/app.php

<pre class="brush:php;toolbar:false;">// config/app.php
'providers' => [
    // ...
    Superbalist\LaravelGoogleCloudStorage\GoogleCloudStorageServiceProvider::class,
]

config/filesystems.php

gcs

<pre class="brush:php;toolbar:false;">// config/filesystems.php
'disks' => [
    // ... 其他磁盘配置
    'gcs' => [
        'driver' => 'gcs',
        'project_id' => env('GOOGLE_CLOUD_PROJECT_ID', 'your-project-id'), // 你的 GCP 项目 ID
        'key_file' => env('GOOGLE_CLOUD_KEY_FILE', null), // 可选：服务账户密钥文件路径，例如 /path/to/service-account.json
        'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET', 'your-bucket'), // 你的 GCS 存储桶名称
        'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', null), // 可选：存储桶内的路径前缀
        'storage_api_uri' => env('GOOGLE_CLOUD_STORAGE_API_URI', null), // 可选：自定义域名
        'visibility' => 'public', // 可选：文件默认可见性，public 或 private
    ],
],

project_id

key_file

bucket

.env

<pre class="brush:php;toolbar:false;"># .env 文件
GOOGLE_CLOUD_PROJECT_ID=your-gcp-project-id
GOOGLE_CLOUD_KEY_FILE=/path/to/your/service-account-key.json
GOOGLE_CLOUD_STORAGE_BUCKET=your-gcs-bucket-name

key_file

Storage

<pre class="brush:php;toolbar:false;">use Illuminate\Support\Facades\Storage;

// 获取 GCS 磁盘实例
$disk = Storage::disk('gcs');

// 1. 上传文件
$fileContents = 'Hello, Google Cloud Storage!';
$disk->put('documents/hello.txt', $fileContents);
echo "文件已上传到 GCS！\n";

// 2. 检查文件是否存在
if ($disk->exists('documents/hello.txt')) {
    echo "文件 'documents/hello.txt' 存在。\n";
}

// 3. 获取文件的公共 URL
$url = $disk->url('documents/hello.txt');
echo "文件公共 URL: " . $url . "\n";
// 默认情况下，URL 格式为：http://storage.googleapis.com/your-bucket-name/documents/hello.txt
// 如果配置了自定义 storage_api_uri，则会使用你的自定义域名。

// 4. 复制文件
$disk->copy('documents/hello.txt', 'documents/hello_copy.txt');
echo "文件已复制。\n";

// 5. 移动文件
$disk->move('documents/hello_copy.txt', 'archive/hello_archived.txt');
echo "文件已移动。\n";

// 6. 设置文件可见性（例如，从 private 改为 public）
$disk->setVisibility('documents/hello.txt', 'public');
echo "文件可见性已设置为 public。\n";

// 7. 删除文件
$disk->delete('documents/hello.txt');
echo "文件已删除。\n";

Storage

superbalist/laravel-google-cloud-storage

superbalist/laravel-google-cloud-storage