产品简介
flysystem-google-drive-ext 这是一个 Flysystem 的 Google Drive 适配器，能将 Google Drive 的文件 ID 自动转换为可读路径，解决与其他存储服务集成的难题。适合需要将 Google Drive 无缝整合到 PHP 或 Laravel 应用中的开发者。
核心功能
- 无缝路径翻译，自动转换虚拟和显示路径
- 支持 Flysystem V2/V3 和 Laravel 9.x 以上版本
- 支持 Team Drive 和共享文件夹连接
- 提供文件上传、下载和列表操作功能
- 易于配置和集成到 Laravel 框架
快速开始
- 第一步：通过 composer 安装 masbug/flysystem-google-drive-ext 包
- 第二步：遵循 Google 文档获取 client ID、client secret 和 refresh token
- 第三步：在代码中创建 Google Client 并配置 Flysystem 适配器
- 第四步：使用文件系统方法进行文件操作，如上传、下载和列表
界面预览
与其他方案对比
| 对比项 | flysystem-google-drive-ext | 同类方案 |
|---|---|---|
| 路径处理 | 自动无缝转换虚拟路径和显示路径，无需手动处理 ID | 通常需要手动处理 Google Drive 的唯一文件 ID |
| 版本兼容性 | 支持 Flysystem V2/V3 和 Laravel 9.x 以上版本，兼容最新技术栈 | 可能只支持旧版本 Flysystem 或 Laravel |
适合谁用
- 使用 Laravel 框架的 web 开发者，需要集成 Google Drive 作为存储后端
- PHP 开发者，在项目中需要管理 Google Drive 文件路径
- 希望简化云存储集成的项目团队，使用 Flysystem 统一管理多个服务
下载与版本
当前最新版本为 v2.5.0，发布于 2026-04-13。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/masbug/flysystem-google-drive-ext