Laravel 10下如何用phpdocx直接将文档存入Google Cloud Storage

AI 小北

2026-7-3

Laravel 10 下 phpdocx 直接将文档存入 Google Cloud Storage

实现思路

跳过本地存储的核心是让 phpdocx 把处理后的文档输出到内存流，再直接通过 Laravel 自带的 Filesystem 上传到 GCS，不用先写本地文件。

步骤1：配置 Laravel 的 GCS 存储

首先确保 Laravel 已经集成了 GCS 磁盘：

安装依赖包：

composer require league/flysystem-google-cloud-storage "^3.0"

在 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' => 'private', // 按需设为 public 或 private
    ],
],

在 .env 文件中填写对应的 GCS 环境变量：

GOOGLE_CLOUD_PROJECT_ID=你的项目ID
GOOGLE_CLOUD_KEY_FILE=密钥文件路径（或直接写JSON内容）
GOOGLE_CLOUD_STORAGE_BUCKET=你的存储桶名称

步骤2：修改 phpdocx 代码直接输出到 GCS

利用 phpdocx 支持输出到内存流的特性，结合 Laravel 的 Storage 门面完成上传：

// 打开一个内存临时流
$tempStream = fopen('php://temp', 'r+');

// 让 phpdocx 将处理后的文档写入内存流
$newDocx->searchAndReplace($docxFromPath, 'php://temp', 'Company Name', 'Apple', $options);

// 将流指针移到开头，方便后续读取
rewind($tempStream);

// 上传到 GCS 指定路径
Storage::disk('gcs')->put('agreements/docx/' . $fileName, $tempStream);

// 关闭临时流
fclose($tempStream);