setup-php项目在本地测试时PHP 8.3扩展安装卡顿问题分析

在使用setup-php项目进行本地测试时，开发者可能会遇到PHP 8.3环境下扩展安装过程卡顿的问题。这个问题特别容易在使用act工具模拟GitHub Actions工作流时出现。

问题现象

当开发者尝试在本地使用act工具运行包含setup-php动作的工作流时，特别是在PHP 8.3环境下安装扩展（如mbstring、dom、fileinfo、pgsql等）时，安装过程会卡住，最终需要手动终止。控制台会显示类似"php: symbol lookup error: php: undefined symbol: crypto_core_ristretto255_scalar_invert"的错误信息。

根本原因

这个问题的主要原因是act工具与setup-php项目的兼容性问题。setup-php项目在GitHub Actions环境中运行良好，但在本地使用act模拟时，对Docker镜像有特定要求：

1. act工具默认使用的node基础镜像与setup-php项目不兼容
2. 本地环境缺少必要的依赖项
3. 符号链接解析错误导致扩展安装失败

解决方案

要解决这个问题，开发者可以采取以下措施：

1. 使用专用Docker镜像：在本地测试时，应该使用专门为setup-php项目优化的Docker镜像，而不是默认的node镜像。

2. 检查系统依赖：确保本地系统安装了所有必要的依赖项，特别是与PHP扩展相关的库。

3. 验证环境配置：确认PHP环境配置正确，特别是与加密相关的模块。

4. 考虑替代测试方案：如果act工具在本地测试中持续出现问题，可以考虑：

   • 直接在GitHub Actions环境中测试
   • 使用其他本地测试工具
   • 搭建与GitHub Actions环境相似的本地Docker环境

最佳实践建议

为了避免类似问题，建议开发者在本地测试PHP工作流时：

1. 仔细阅读setup-php项目的文档，了解本地测试的特殊要求
2. 使用项目推荐的Docker镜像
3. 保持本地Docker环境与CI环境尽可能一致
4. 定期更新所有相关工具和依赖项

通过遵循这些建议，开发者可以更顺利地在本地环境中测试PHP项目的工作流，避免扩展安装卡顿等问题。