如何在PHP及Laravel中实现Google Drive API v3文件共享功能？

架构老林

2026-5-19

嘿，这两个问题我刚好有实操经验，给你一步步拆解：

问题1：如何在PHP中通过Google Drive API v3实现文件共享？

首先得确保你已经搞定了基础配置：

已经在Google Cloud Console创建了项目，启用了Drive API，拿到了OAuth2的凭证（JSON文件）
通过Composer安装了官方的客户端包：composer require google/apiclient:^2.0

接下来直接上实操步骤：

初始化Google客户端并完成授权

require __DIR__ . '/vendor/autoload.php';

$client = new Google\Client();
$client->setApplicationName('Drive API File Sharing');
$client->setScopes([Google\Service\Drive::DRIVE_FILE]); // 按需调整范围，DRIVE_FILE比全权限DRIVE更安全
$client->setAuthConfig('path/to/your/credentials.json');
$client->setAccessType('offline');
$client->setPrompt('select_account consent');

// 假设你已经有有效访问令牌，若无则需先完成授权流程获取
$accessToken = 'your-existing-access-token';
$client->setAccessToken($accessToken);

// 令牌过期自动刷新
if ($client->isAccessTokenExpired()) {
    if ($client->getRefreshToken()) {
        $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
    } else {
        exit('需要重新引导用户完成授权');
    }
}

创建共享权限
用Google\Service\Drive的permissions->create方法添加共享权限，核心是指定文件ID、角色和共享对象类型：

$driveService = new Google\Service\Drive($client);

$fileId = 'your-target-file-id'; // 要共享的文件ID
$permission = new Google\Service\Drive\Permission([
    'type' => 'user', // 可选值：user、group、domain、anyone
    'role' => 'writer', // 可选值：owner、writer、reader、commenter
    'emailAddress' => 'user@example.com' // type为user/group时必填
]);

// 可选参数：是否发送通知邮件及自定义消息
$params = [
    'sendNotificationEmail' => true,
    'emailMessage' => '我共享了一个文件给你，快来看看！'
];

try {
    $result = $driveService->permissions->create($fileId, $permission, $params);
    echo "共享成功，权限ID：" . $result->getId();
} catch (Exception $e) {
    echo "共享失败：" . $e->getMessage();
}

注意点：

若共享给所有人（type: 'anyone'），无需填写emailAddress，但要注意隐私风险
不要随意分配owner角色，除非你确实要转移文件所有权
必须捕获异常，文件不存在、权限不足、重复添加权限等情况都会抛出错误

问题2：已获取文件列表，如何在Laravel中为Google Drive API v3添加文件共享功能？

Laravel里可以把Google Drive客户端封装成服务，复用性更高，和现有文件列表功能集成也更顺畅：

基础准备
先安装依赖：composer require google/apiclient:^2.0
然后在.env里添加配置（替换成你的实际信息）：

GOOGLE_DRIVE_CLIENT_ID=your-client-id
GOOGLE_DRIVE_CLIENT_SECRET=your-client-secret
GOOGLE_DRIVE_REDIRECT_URI=http://your-app-url.com/auth/google/callback
GOOGLE_DRIVE_CREDENTIALS_PATH=storage/app/google-credentials.json
GOOGLE_DRIVE_ACCESS_TOKEN=your-access-token
GOOGLE_DRIVE_REFRESH_TOKEN=your-refresh-token

创建Google Drive服务提供者
运行命令生成服务提供者：php artisan make:provider GoogleDriveServiceProvider
然后在register方法里绑定客户端到容器：

<?php

namespace App\Providers;

use Google\Client;
use Google\Service\Drive;
use Illuminate\Support\ServiceProvider;

class GoogleDriveServiceProvider extends ServiceProvider
{
    public function register()
    {
        $this->app->singleton(Drive::class, function ($app) {
            $client = new Client();
            $client->setApplicationName('Laravel Drive API');
            $client->setScopes([Drive::DRIVE_FILE]);
            $client->setAuthConfig(storage_path('app/' . env('GOOGLE_DRIVE_CREDENTIALS_PATH')));
            $client->setAccessToken(json_decode(env('GOOGLE_DRIVE_ACCESS_TOKEN'), true));
            
            // 自动刷新令牌并更新.env（多用户场景建议存数据库）
            if ($client->isAccessTokenExpired()) {
                if ($refreshToken = env('GOOGLE_DRIVE_REFRESH_TOKEN')) {
                    $client->fetchAccessTokenWithRefreshToken($refreshToken);
                    file_put_contents(base_path('.env'), str_replace(
                        'GOOGLE_DRIVE_ACCESS_TOKEN=' . env('GOOGLE_DRIVE_ACCESS_TOKEN'),
                        'GOOGLE_DRIVE_ACCESS_TOKEN=' . json_encode($client->getAccessToken()),
                        file_get_contents(base_path('.env'))
                    ));
                } else {
                    abort(403, 'Google Drive令牌过期，需要重新授权');
                }
            }

            return new Drive($client);
        });
    }
}

记得在config/app.php的providers数组里注册这个服务提供者。

封装共享方法（与现有文件列表控制器集成）
直接在处理文件列表的控制器里注入Drive服务，新增共享方法：

<?php

namespace App\Http\Controllers;

use Google\Service\Drive;
use Google\Service\Drive\Permission;
use Illuminate\Http\Request;

class DriveFileController extends Controller
{
    protected $driveService;

    public function __construct(Drive $driveService)
    {
        $this->driveService = $driveService;
    }

    // 已实现的文件列表方法
    public function index()
    {
        $files = $this->driveService->files->listFiles();
        return view('drive.files', compact('files'));
    }

    // 新增的文件共享方法
    public function share(Request $request)
    {
        $request->validate([
            'file_id' => 'required|string',
            'email' => 'required|email',
            'role' => 'required|in:reader,writer,commenter'
        ]);

        try {
            $permission = new Permission([
                'type' => 'user',
                'role' => $request->role,
                'emailAddress' => $request->email
            ]);

            $this->driveService->permissions->create(
                $request->file_id,
                $permission,
                ['sendNotificationEmail' => true]
            );

            return back()->with('success', '文件共享成功！');
        } catch (\Exception $e) {
            return back()->with('error', '共享失败：' . $e->getMessage());
        }
    }
}

前端集成（与现有文件列表联动）
在文件列表视图中，给每个文件添加共享按钮和模态框表单：

@foreach($files as $file)
    <div class="file-item">
        <span>{{ $file->name }}</span>
        <!-- 共享按钮 -->
        <button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#shareModal{{ $file->id }}">
            共享文件
        </button>

        <!-- 共享模态框 -->
        <div class="modal fade" id="shareModal{{ $file->id }}" tabindex="-1">
            <div class="modal-dialog">
                <form action="{{ route('drive.files.share') }}" method="POST">
                    @csrf
                    <input type="hidden" name="file_id" value="{{ $file->id }}">
                    <div class="modal-content">
                        <div class="modal-header">
                            <h5 class="modal-title">共享文件：{{ $file->name }}</h5>
                        </div>
                        <div class="modal-body">
                            <div class="mb-3">
                                <label for="email" class="form-label">共享给邮箱</label>
                                <input type="email" class="form-control" id="email" name="email" required>
                            </div>
                            <div class="mb-3">
                                <label for="role" class="form-label">权限</label>
                                <select class="form-select" id="role" name="role" required>
                                    <option value="reader">查看者</option>
                                    <option value="writer">编辑者</option>
                                    <option value="commenter">评论者</option>
                                </select>
                            </div>
                        </div>
                        <div class="modal-footer">
                            <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">取消</button>
                            <button type="submit" class="btn btn-primary">确认共享</button>
                        </div>
                    </div>
                </form>
            </div>
        </div>
    </div>
@endforeach

最后在routes/web.php添加共享路由：

Route::post('/drive/files/share', [DriveFileController::class, 'share'])->name('drive.files.share');

额外提示：

多用户场景建议把令牌存数据库，而非.env
可以扩展权限管理功能，比如用permissions->list查看已有权限、permissions->delete删除权限

内容的提问来源于stack exchange，提问作者ujjal