解决 setup-php 项目中 PHP 8.1 的 Redis 模块重复加载警告

在 PHP 开发环境中，使用 setup-php 工具配置 PHP 8.1 版本时，可能会遇到一个常见问题：系统提示"Module 'redis' is already loaded"的警告信息。这个问题不仅会影响开发体验，还会导致某些严格检查 PHP 警告的持续集成流程（如 moodlehq/moodle-plugin-ci）失败。

问题根源分析

经过深入调查，我们发现这个问题的根本原因在于 Redis 扩展的配置文件重复加载。具体表现为：

1. 在 Ubuntu 22.04 的 GitHub 托管运行器镜像中，Redis 扩展已经预装了配置文件，优先级为20（20-redis.ini）
2. 当 setup-php 运行时，它会再次添加 Redis 扩展的配置文件，但使用了新的优先级25（25-redis.ini）
3. PHP 在启动时会加载这两个配置文件，导致 Redis 模块被重复加载

这种重复加载行为源于 php-redis 包的最新更新（6.0.2-4版本），其中特意将 Redis 扩展的加载优先级从20调整到了25。

解决方案

针对不同 Ubuntu 版本，解决方案略有差异：

对于 Ubuntu 22.04 和 24.04 用户

setup-php 项目团队已经通过提交修复了这个问题。用户无需采取任何额外操作，只需继续正常使用最新版本的 setup-php 即可。

对于 Ubuntu 20.04 用户

需要在工作流配置文件中添加一个环境变量设置：

env:
  update: true

这个设置会触发必要的更新流程，解决 Redis 模块重复加载的问题。

技术背景

在 PHP 的扩展加载机制中，.ini 文件前面的数字表示加载顺序。当同一个扩展被不同优先级的配置文件多次声明时，PHP 会尝试多次加载该扩展，从而产生警告。理想情况下，扩展应该只被加载一次。

setup-php 作为一个 PHP 环境配置工具，需要处理各种 PHP 版本和扩展的组合。这次问题的出现展示了在持续集成环境中管理 PHP 扩展的复杂性，特别是在基础镜像已经预装某些组件的情况下。

最佳实践

为了避免类似问题，建议开发者：

1. 定期检查 CI/CD 流水线中的 PHP 警告信息
2. 了解所用基础镜像中预装的 PHP 组件
3. 保持 setup-php 工具更新到最新版本
4. 对于关键项目，考虑在 CI 流程中添加扩展配置检查步骤

通过理解这些底层机制，开发者可以更好地诊断和解决 PHP 环境配置中的各种问题，确保开发流程的顺畅进行。