setup-php 项目中 PHP 8.3 版本安装异常问题分析

在 GitHub Actions 中使用 setup-php 工具时，开发者发现了一个关于 PHP 8.3 版本安装的特殊问题。当工作流中两次调用 setup-php 时，第二次安装 PHP 8.3 会出现版本不一致的情况，而其他 PHP 版本则表现正常。

问题现象

开发者通过详细测试发现，当工作流中只安装一次 PHP 时，所有版本（包括 PHP 8.3）都能正确安装最新稳定版本。然而，当工作流中第二次安装 PHP 8.3 时，安装的版本会回退到 8.3.6，而不是最新的 8.3.14。

问题根源

经过项目维护者的深入调查，发现问题源于 Ubuntu 24.04 系统的一个特性。Ubuntu 24.04 默认预装了 PHP 8.3.6 版本，而 setup-php 工具在安装 PHP 时有一个优化逻辑：如果系统已经安装了目标 PHP 版本，并且 ondrej/php PPA 源已经存在，则不会强制更新到最新版本。

在第一次运行 setup-php 时（比如安装 PHP 7.4），工具会添加 ondrej/php PPA 源。当第二次运行时，由于 PPA 源已存在，工具不会强制更新 PHP 版本，导致系统保留了预装的 PHP 8.3.6 而非更新到最新版本。

解决方案

项目维护者提供了两种解决方案：

1. 临时解决方案：在 setup-php 步骤中添加 update: true 环境变量，强制工具更新 PHP 版本。
2. 永久修复：项目已在 2.32.0 版本中修复了此问题，优化了后续运行中的更新逻辑。

技术启示

这个问题揭示了 CI/CD 工具与环境预装软件之间可能存在的微妙交互。对于依赖系统预装软件的工具来说，需要特别注意：

1. 不同操作系统版本可能预装不同版本的软件
2. 工具需要明确区分"首次安装"和"后续运行"的逻辑
3. 版本控制策略需要考虑系统环境的影响

这个问题也提醒开发者，在使用 CI/CD 工具时，应该：

• 明确指定所需的软件版本
• 了解基础镜像的预装内容
• 在遇到版本问题时检查工具的更新机制

setup-php 项目团队对此问题的快速响应和修复，展示了开源项目对用户体验的重视，也为其他类似工具的开发提供了有价值的参考案例。