解决 setup-php 在自托管环境中 PHP 8.4 的兼容性问题

在自托管环境中使用 setup-php 工具配置 PHP 8.4 时，开发者可能会遇到两个主要问题：mbstring 扩展加载失败和 PHP 版本不匹配。这些问题通常表现为运行时警告和依赖冲突。

mbstring 扩展加载失败的具体错误信息显示，系统尝试加载 mbstring.so 时遇到了未定义符号的问题。这通常是由于扩展与 PHP 核心库之间的版本不兼容导致的。错误信息中提到的 zend_get_property_info_for_slot_slow 符号缺失表明扩展可能是为不同版本的 PHP 编译的。

PHP 版本不匹配问题表现为 Composer 检测到的 PHP 版本（8.4.4）与预期版本（8.4.6）不一致。这种不一致会导致依赖解析失败，特别是当项目明确指定了 PHP 版本约束时。

针对这些问题，解决方案包括：

1. 明确指定运行环境为自托管模式，在 setup-php 步骤中添加 runner: self-hosted 环境变量。这能确保工具正确识别环境类型并采取相应的配置策略。

2. 对于扩展加载问题，可以尝试以下方法：

   • 确保系统已安装所有必要的依赖库
   • 检查扩展是否针对当前 PHP 版本正确编译
   • 考虑手动禁用可能引起冲突的扩展（如 sqlsrv）

3. 版本管理方面，建议：

   • 明确指定所需的 PHP 次要版本
   • 定期更新自托管环境中的 PHP 安装
   • 验证工具链中各组件版本的一致性

setup-php 从 2.34.0 版本开始改进了对自托管环境的检测逻辑，能更好地处理这类兼容性问题。对于持续出现问题的环境，建议升级到最新版本并重新测试。

这些解决方案不仅适用于 PHP 8.4，也适用于其他版本在自托管环境中可能遇到的类似问题。通过正确配置环境变量和版本约束，可以显著提高构建过程的稳定性和可靠性。