解决 setup-php 项目中 MongoDB 扩展安装失败问题

在 PHP 开发环境中，使用 setup-php 项目配置 MongoDB 扩展时可能会遇到安装失败的情况。本文将通过一个实际案例，分析问题原因并提供解决方案。

问题现象

开发者在 GitHub Actions 工作流中尝试安装 mongodb-1.20 扩展时遇到了问题。安装过程中只显示"Enabled"状态，无法确认实际安装的版本号，导致后续测试用例失败。

问题分析

这种问题通常与扩展的构建缓存有关。setup-php 项目为了提高安装效率，会缓存预编译的 PHP 扩展。当缓存中的扩展版本与请求安装的版本不匹配或缓存过期时，就会出现安装异常。

解决方案

对于这类问题，最有效的解决方法是更新构建缓存。项目维护者可以通过以下步骤解决问题：

1. 识别缓存过期或损坏的情况
2. 触发缓存更新流程
3. 验证新缓存是否包含正确的扩展版本

在实际操作中，维护者确认更新构建缓存后，问题得到解决。这确保了用户可以正常安装指定版本的 MongoDB 扩展。

后续维护

随着 PHP 生态的发展，扩展会不断更新。例如 MongoDB 扩展后续发布了 1.21.0 版本。维护团队需要定期更新构建缓存，以支持新版本的扩展安装。

最佳实践

对于使用 setup-php 的开发者，建议：

1. 明确指定需要的扩展版本
2. 关注工作流日志中的扩展安装状态
3. 遇到问题时检查是否为已知的缓存问题
4. 及时向项目维护者报告异常情况

通过理解这些底层机制，开发者可以更高效地解决环境配置问题，专注于业务代码开发。