优化 Google API PHP 客户端库：管理不必要的服务依赖

Google API PHP 客户端库的依赖挑战

Google API PHP 客户端库（google/apiclient）是一个功能强大的工具，用于与各种 Google 服务进行交互。然而，其便利性也带来了一个常见的挑战：库的体积相对较大。这是因为 google/apiclient 旨在支持超过 200 种不同的 Google API 服务，这意味着它默认会包含所有这些服务的定义和相关代码。对于大多数应用而言，通常只会用到其中少数几种服务，因此，如何有效管理并移除项目中不必要的服务依赖，成为开发者关注的重点，以期减小部署包大小、提升加载效率。

核心依赖关系解析：google/apiclient 与 google/apiclient-services

理解 google/apiclient 的依赖结构是进行有效清理的前提。实际上，google/apiclient 库本身并没有直接包含所有服务的代码。它通过 Composer 强制依赖于另一个名为 google/apiclient-services 的包。这个 google/apiclient-services 包才是真正包含了所有 Google API 服务定义的集合。

这意味着，无论您的项目实际使用了多少 Google 服务，只要您安装了 google/apiclient，Composer 就会自动将其依赖 google/apiclient-services 一并安装到您的 vendor 目录中。因此，试图通过简单地不安装某些服务来“摆脱”整个庞大库的想法是不切实际的，因为 google/apiclient-services 作为一个整体依赖是不可分割的。

理解 Composer 清理任务的真正作用

尽管 google/apiclient-services 包总是会被安装，但 google/apiclient 库提供了一个官方的清理机制来解决其内部服务文件过多的问题。在 google/apiclient 的 README.md 中，有一个名为“清理未使用的服务”（Cleaning up unused services）的章节，明确指出可以通过运行 GoogleTaskComposer::cleanup 任务并指定需要保留的服务来避免将所有依赖项随代码一起部署。

立即学习“PHP免费学习笔记（深入）”；

这个 GoogleTaskComposer::cleanup 任务的实际作用并非阻止 google/apiclient-services 包的安装，而是在 Composer 完成 post-install-cmd 或 post-update-cmd 阶段后执行。它会检查您在 composer.json 中配置的需要保留的服务列表，然后从 vendor/google/apiclient-services 目录中删除所有 未在列表中指定 的服务相关文件。

简而言之，清理任务的作用是：

JoinMC智能客服

JoinMC智能客服，帮您熬夜加班，7X24小时全天候智能回复用户消息，自动维护媒体主页，全平台渠道集成管理，电商物流平台一键绑定，让您出海轻松无忧！

23

查看详情

• 不影响 google/apiclient-services 包的整体安装。
• 在安装完成后，从已安装的 google/apiclient-services 包中移除未使用的服务文件。
• 减少了项目在磁盘上的实际占用空间，并可能在一定程度上优化运行时资源消耗（因为未使用的类不会被加载）。

如何配置 composer.json 进行服务清理

要利用这个清理任务，您需要在项目的 composer.json 文件中添加一个 extra 配置项，指定您希望保留的 Google 服务。这些服务名称通常是 API 的短名称，例如 Drive、Gmail、YouTube 等。

以下是一个配置示例，假设您的应用只使用了 Google Drive 和 Google Calendar 服务：

{
    "require": {
        "php": ">=7.4",
        "google/apiclient": "^2.12"
    },
    "extra": {
        "google": {
            "apiclient": {
                "services": [
                    "Drive",
                    "Calendar"
                ]
            }
        }
    },
    "scripts": {
        "post-install-cmd": [
            "Google\Task\Composer::cleanup"
        ],
        "post-update-cmd": [
            "Google\Task\Composer::cleanup"
        ]
    }
}

配置说明：

• "require": 包含 google/apiclient 库的依赖。
• "extra": 这是 Composer 允许自定义配置的区域。
  • "google": 针对 Google 相关的配置。
    • "apiclient": 针对 Google API 客户端库的配置。
      • "services": 这是一个数组，列出了您希望在项目中保留的 Google 服务名称。请务必根据您的实际需求填写。
• "scripts": 确保 GoogleTaskComposer::cleanup 任务在 Composer 安装或更新依赖后自动运行。这通常是默认配置，但手动添加可以确保其执行。

配置完成后，运行 composer update 或 composer install 命令。Composer 将会下载所有依赖，然后 GoogleTaskComposer::cleanup 任务会自动执行，移除 vendor/google/apiclient-services 目录中未在 services 列表中指定的其他服务文件。

注意事项与最佳实践

1. 避免手动删除： 之前在 Stack Overflow 上有人提出不应尝试移除 Google API 库的未使用依赖，因为这可能导致未来出现问题。这个警告主要是针对 手动 删除 vendor 目录中的文件。使用 GoogleTaskComposer::cleanup 任务是官方推荐且安全的方法，因为它遵循了库设计者的意图。
2. 精确识别所需服务： 在配置 services 列表时，务必仔细检查您的项目实际使用了哪些 Google 服务。如果误删了某个服务，您的应用将无法正常工作，并可能抛出类未找到（Class Not Found）的错误。
3. 重新运行 Composer 命令： 每次修改 composer.json 中的 extra.google.apiclient.services 配置后，都必须运行 composer update 或 composer install 命令，以触发清理任务并应用新的服务列表。
4. 版本控制： 始终将您的 composer.json 和 composer.lock 文件纳入版本控制，以确保团队成员和部署环境中的依赖一致性。
5. 服务名称查询： 如果不确定某个 Google API 的服务名称，通常可以在 google/apiclient-services 库的源代码目录结构中找到，例如 vendor/google/apiclient-services/src/Google/Service/ 下的子目录名。

总结

通过 composer.json 配置 extra.google.apiclient.services 并配合 GoogleTaskComposer::cleanup 任务，是优化 Google API PHP 客户端库体积的有效且官方推荐的方法。虽然 google/apiclient-services 包作为一个整体依赖总是会被安装，但此清理机制允许您在安装后移除其中未使用的具体服务文件，从而显著减小项目在磁盘上的占用空间。正确理解并应用这一机制，将有助于您构建更精简、高效的 PHP 应用。

以上就是优化 Google API PHP 客户端库：管理不必要的服务依赖的详细内容，更多请关注php中文网其它相关文章！