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）的章节，明确指出可以通过运行 Google\Task\Composer::cleanup 任务并指定需要保留的服务来避免将所有依赖项随代码一起部署。
立即学习“PHP免费学习笔记（深入）”；
这个 Google\Task\Composer::cleanup 任务的实际作用并非阻止 google/apiclient-services 包的安装，而是在 Composer 完成 post-install-cmd 或 post-update-cmd 阶段后执行。它会检查您在 composer.json 中配置的需要保留的服务列表，然后从 vendor/google/apiclient-services 目录中删除所有 未在列表中指定 的服务相关文件。
简而言之，清理任务的作用是：
- 不影响 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 服务名称。请务必根据您的实际需求填写。
- "apiclient": 针对 Google API 客户端库的配置。
- "google": 针对 Google 相关的配置。
- "scripts": 确保 Google\Task\Composer::cleanup 任务在 Composer 安装或更新依赖后自动运行。这通常是默认配置，但手动添加可以确保其执行。
配置完成后，运行 composer update 或 composer install 命令。Composer 将会下载所有依赖，然后 Google\Task\Composer::cleanup 任务会自动执行，移除 vendor/google/apiclient-services 目录中未在 services 列表中指定的其他服务文件。
注意事项与最佳实践
- 避免手动删除： 之前在 Stack Overflow 上有人提出不应尝试移除 Google API 库的未使用依赖，因为这可能导致未来出现问题。这个警告主要是针对 手动 删除 vendor 目录中的文件。使用 Google\Task\Composer::cleanup 任务是官方推荐且安全的方法，因为它遵循了库设计者的意图。
- 精确识别所需服务： 在配置 services 列表时，务必仔细检查您的项目实际使用了哪些 Google 服务。如果误删了某个服务，您的应用将无法正常工作，并可能抛出类未找到（Class Not Found）的错误。
- 重新运行 Composer 命令： 每次修改 composer.json 中的 extra.google.apiclient.services 配置后，都必须运行 composer update 或 composer install 命令，以触发清理任务并应用新的服务列表。
- 版本控制： 始终将您的 composer.json 和 composer.lock 文件纳入版本控制，以确保团队成员和部署环境中的依赖一致性。
- 服务名称查询： 如果不确定某个 Google API 的服务名称，通常可以在 google/apiclient-services 库的源代码目录结构中找到，例如 vendor/google/apiclient-services/src/Google/Service/ 下的子目录名。
总结
通过 composer.json 配置 extra.google.apiclient.services 并配合 Google\Task\Composer::cleanup 任务，是优化 Google API PHP 客户端库体积的有效且官方推荐的方法。虽然 google/apiclient-services 包作为一个整体依赖总是会被安装，但此清理机制允许您在安装后移除其中未使用的具体服务文件，从而显著减小项目在磁盘上的占用空间。正确理解并应用这一机制，将有助于您构建更精简、高效的 PHP 应用。
