php项目在jenkins上失败主因是环境、路径或权限未对齐：需确认jenkins用户已安装php、path包含php路径、具备读取私钥和.env权限；构建前应验证php --version、composer源及扩展，并显式指定phpunit配置与工作目录。
PHP 项目在 Jenkins 上跑不起来，八成不是 PHP 本身的问题，而是环境、路径或权限没对齐。Jenkins 默认用 jenkins 用户执行任务，而这个用户通常没装 PHP、没配 PATH、也没读取项目私钥或 .env 的权限——先确认这三点，比调脚本快得多。
确认 Jenkins 服务器已安装且可调用 PHP
Jenkins 任务里写 php --version 报“command not found”，说明它根本找不到 PHP。别默认系统 PHP 就可用，Jenkins 启动方式（systemd / war / docker）决定了它的环境变量来源。
- 如果是 systemd 启动的 Jenkins，
systemctl edit jenkins加上Environment="PATH=/usr/local/bin:/usr/bin:/bin"，确保包含 PHP 所在路径（用which php确认） - 在 Jenkins 任务的 “Execute shell” 步骤开头加一行：
echo $PATH && which php && php --version，直接看实际运行时的环境 - 避免用
sudo apt install php装完就以为万事大吉——Ubuntu 22.04 默认装的是php8.1，命令是php8.1，不是php；要么装php-cli包，要么用update-alternatives --config php指定默认版本
composer install 失败：权限、源、PHP 版本三连坑
composer install 在 Jenkins 里卡住或报错，常见于三个地方：缓存目录归属、国内源配置丢失、PHP 扩展缺失。
- Jenkins 用户（如
jenkins）对~/.composer没写权限 → 在构建前加：sudo -u jenkins mkdir -p /var/lib/jenkins/.composer && sudo -u jenkins chown -R jenkins:jenkins /var/lib/jenkins/.composer - 本地
composer config -g repo.packagist composer https://packagist.phpcomposer.com对 Jenkins 无效 → 在构建步骤里显式指定源：composer config -g repo.packagist composer https://packagist.org（注意：国内源如腾讯、阿里已逐步停用，优先用官方 HTTPS 源 +COMPOSER_HOME环境变量隔离） - 报
ext-zip not loaded或mbstring is missing→ 不要依赖系统默认扩展，用php -m | grep -E 'zip|mbstring'验证，缺啥装啥，例如 Ubuntu 上：sudo apt install php-zip php-mbstring，然后重启 Jenkins（或 reload php-fpm，视情况而定）
PHPUnit 测试跑不起来：autoload、配置、超时全得手动管
Jenkins 里 vendor/bin/phpunit 执行失败，往往因为自动加载没生效，或 XML 配置路径不对，甚至只是超时被 kill。
- 别依赖当前目录自动找
phpunit.xml—— 显式指定：vendor/bin/phpunit --configuration ./phpunit.xml --testsuite unit - 如果报
Class 'Tests\TestCase' not found，大概率是composer dump-autoload -o没跑，或autoload-dev段没生效 → 在composer install后补一句：composer dump-autoload --optimize --classmap-authoritative - Jenkins 默认 Shell 步骤超时是 10 分钟，大型测试集容易被杀 → 进入任务配置 → “Build Environment” → 勾选 “Abort the build if it's stuck” 并调高 timeout，或改用
timeout 30m vendor/bin/phpunit ...
最常被忽略的一点：Jenkins 构建工作区（workspace）默认在 /var/lib/jenkins/workspace/xxx，但很多 PHP 项目硬编码了 __DIR__ 或 getcwd() 做路径判断，一到 Jenkins 就连日志目录都创建失败。与其到处修代码，不如在构建前统一设好：cd $WORKSPACE && pwd，再跑后续命令——路径问题，永远从 pwd 开始查。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
