必须显式指定 php 8.1 运行时，最稳妥方式是使用官方 docker 镜像 php:8.1-cli（cli 测试）或 php:8.1-apache（web 环境），避免手动安装；phpunit 需 ≥9.5 版本并统一调用 ./vendor/bin/phpunit，部署时注意扩展兼容性与 fpm 配置匹配。
GitLab CI 默认不带 PHP 8.1 环境，直接在 .gitlab-ci.yml 里写 php --version 会报错或返回 7.x —— 必须显式指定 PHP 8.1 运行时，否则测试和部署都可能因版本不匹配失败。
怎么让 GitLab Runner 跑 PHP 8.1？
GitLab Runner 本身不决定 PHP 版本，它靠你指定的 image 或 services 提供运行环境。最稳妥的方式是用官方 PHP Docker 镜像：
- 优先选
php:8.1-cli（轻量、无 Apache/Nginx，适合 CLI 测试） - 若需 Web 环境（比如跑 PHPUnit + 内置服务器），用
php:8.1-apache，但注意要手动启用mod_rewrite和设置 DocumentRoot - 避免用
ubuntu:22.04+ 手动 apt install php8.1 —— 容易因源失效、扩展缺失（如mbstring、xml）导致构建失败
PHPUnit 测试阶段常踩的坑
PHP 8.1 对类型声明更严格，phpunit 版本必须 ≥ 9.5（支持 PHP 8.1），否则会报 Fatal error: Cannot declare class PHPUnit\... because the name is already in use 或 Typed property must not be accessed before initialization。
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
- 检查
composer.json：确保"phpunit/phpunit": "^9.5"或"^10.0"（后者要求 PHP ≥ 8.1.0） - CI 中别依赖全局
phpunit，统一用./vendor/bin/phpunit - 如果项目用了
ext-opcache相关优化（如预加载），CI 阶段建议关闭：php -d opcache.enable=0 ./vendor/bin/phpunit
部署到生产服务器时路径与权限问题
CI 构建产物（如 build/ 或 dist/）默认在 Runner 的临时目录里，直接 rsync 或 scp 到目标服务器时容易因用户权限、SELinux、路径不存在而失败。
- 部署脚本里加前置检查：
ssh $DEPLOY_USER@$HOST 'mkdir -p /var/www/myapp && chown -R $DEPLOY_USER:$DEPLOY_USER /var/www/myapp' - PHP 8.1 的
opcache.validate_root默认为On，部署后首次访问可能 500 —— 建议部署后执行ssh $USER@$HOST 'sudo systemctl reload php8.1-fpm'（如果是 FPM 模式） - 别在
before_script里做composer install --no-dev后直接 rsync 整个 repo 目录；应明确只同步public/、vendor/、.env.production等必要文件，避免泄露.git/或 dev-only 配置
真正麻烦的不是写对 .gitlab-ci.yml，而是 PHP 8.1 的扩展兼容性（比如 igbinary、redis）和部署目标机的 PHP-FPM pool 配置是否匹配 —— 这些不会在 CI 日志里报错，但上线后 502 或白屏才暴露。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
