如何正确使用 Google PHP API 客户端库并解决类未找到错误-php教程-PHP中文网

如何正确使用 Google PHP API 客户端库并解决类未找到错误

本文详解因 Google+ API 已弃用、命名空间迁移及客户端版本过旧导致的 Class 'GoogleServicePlus' not found 错误，并提供兼容现代 Google API 的重构方案。

本文详解因 google+ api 已弃用、命名空间迁移及客户端版本过旧导致的 `class 'googleserviceplus' not found` 错误，并提供兼容现代 google api 的重构方案。

Google+ API 已于 2019 年 3 月完全关闭，其相关服务类（如 GoogleServicePlus）在新版 google/apiclient 中已被彻底移除。你当前代码中引用的 GoogleServicePlus::PLUS_LOGIN 等常量不仅语义失效，更因类定义不存在而直接触发致命错误。这不是自动加载配置问题，而是API 架构演进引发的兼容性断裂。

✅ 正确迁移路径

1. 彻底移除 Google+ 相关逻辑

Google+ 登录与用户信息获取功能已由 Google Identity Services（OAuth 2.0 + UserInfo endpoint） 取代。请改用标准 OpenID Connect 流程：

// 替代方案：使用 Google OAuth 2.0 获取用户邮箱和基础资料
$client = new GoogleClient();
$client->setApplicationName('Your App');
$client->setScopes([
    'https://www.googleapis.com/auth/userinfo.email',
    'https://www.googleapis.com/auth/userinfo.profile',
]);
$client->setAuthConfig('credentials.json'); // OAuth 2.0 凭据文件
$client->setAccessType('offline');

// 生成授权 URL（前端重定向）
$authUrl = $client->createAuthUrl();

// 回调处理（获取 access token 后）
if (isset($_GET['code'])) {
    $token = $client->fetchAccessTokenWithAuthCode($_GET['code']);
    $client->setAccessToken($token);

    // 调用 UserInfo API（非 Plus 服务）
    $oauth2 = new GoogleServiceOauth2($client);
    $userInfo = $oauth2->userinfo->get();
    echo "Email: " . $userInfo->getEmail() . "
";
}

2. 更新依赖并统一命名空间规范

你当前混合使用多个 Google SDK（googleads-php-lib、google-ads-php、google/cloud-storage），需确保版本协同。关键建议如下：

✅ 将 "google/apiclient" 升级至 ^2.12.1（或更高稳定版如 ^2.15.0），该版本全面采用 PSR-4 命名空间，且已移除所有 Plus 类；
❌ 删除 googleads/googleads-php-lib（已归档，仅支持旧 AdWords API）；如需 Google Ads，请仅保留官方维护的 "googleads/google-ads-php": "^14.0"；
✅ 所有服务类均通过 GoogleService{ServiceName} 访问（如 GoogleServiceDrive、GoogleServiceSheets），不再存在下划线风格类名（如 Google_Service_Plus）。

更新后的 composer.json 推荐片段：

SerpApi Flights (Google Flights)

通过 SerpApi 查询 Google Flights，获取航班时刻表、价格及舱位等级信息。当用户询问航班 / 机票 / 航班价格、时刻表或对比信息时使用。

下载

"require": {
    "google/apiclient": "^2.15.0",
    "google/cloud-storage": "^1.30",
    "googleads/google-ads-php": "^14.0",
    "phpseclib/phpseclib": "^3.0"
}

⚠️ 注意：phpseclib v2.x 已停止维护，建议升级至 ^3.0（需同步检查 SSH/SFTP 相关代码兼容性）。

3. 验证自动加载是否生效

运行以下命令确认类路径正确注册：

composer dump-autoload -o  # 优化自动加载映射
php -r "var_dump(class_exists('Google\Service\Oauth2'));"  // 应输出 bool(true)

若仍报错，请检查是否误用了 require_once 'vendor/autoload.php' 多次，或存在 spl_autoload_register() 冲突。

总结

Class 'GoogleServicePlus' not found 的根本原因并非 Composer 自动加载失败，而是试图调用一个已被 Google 官方废弃且从 SDK 中物理删除的服务模块。解决方案是：
① 彻底弃用 Google+ 相关代码，改用 Oauth2 服务获取用户信息；
② 升级 google/apiclient 至 ^2.12.1+，严格遵循命名空间规范；
③ 清理冗余 SDK，避免跨版本服务类冲突。
遵循以上步骤，即可安全接入当前所有活跃的 Google Cloud 和 Workspace APIs。