PHPGit自动部署失败怎么解决

PHP线上Git自动部署失败，表面看是钩子没生效，实则深藏四大陷阱：post-receive中PHP等命令未用绝对路径导致直接“失踪”，git用户环境变量缺失与权限错配让Composer和autoload统统失效，错误未捕获致失败静默、排查无门，再加上opcache或Web缓存掩盖真实更新——真正卡点不在代码逻辑，而在于每个命令究竟由谁、在哪个环境、以何种路径执行；一环松动，全链断裂。

git hook 里没用绝对路径，脚本根本找不到 PHP

线上自动部署失败，八成是 post-receive 钩子里调用的 php 命令压根没执行——因为钩子运行在非交互式 shell 下，$PATH 和你本地终端完全不一样，php 命令大概率不在默认搜索路径里。

• 用 which php 在服务器上查真实路径，比如 /usr/bin/php 或 /opt/remi/php82/root/usr/bin/php
• 钩子里所有命令都写绝对路径：/usr/bin/php /var/www/deploy.php，别写 php deploy.php
• 别依赖 ~ 或 ./：钩子工作目录不固定，要用完整路径，比如 /var/repo/site.git/hooks/post-receive

PHP 脚本被 git 用户执行，权限和环境变量全不对

git 推送触发的是 git 用户（或你配的部署用户）跑的钩子，这个用户通常没家目录、没 .bashrc、没 Composer 全局 bin 路径，连 vendor/autoload.php 都 require 不进去。

• 在 PHP 脚本开头加 putenv('HOME=/var/www') 或显式设置关键环境变量
• 不要用 exec('composer install') —— 换成 exec('/usr/bin/composer --no-interaction install')，并确认该用户对 vendor/ 目录有读写权
• 检查 Web 目录属主：如果 PHP 脚本把文件解到 /var/www/html，得确保 git 用户能写，且 Web 服务用户（如 www-data）能读

post-receive 钩子里没捕获错误，失败了也静默

钩子脚本里任何命令出错，默认不会中断，也不会报给推送方，看起来“成功”了，其实 git pull 卡在权限拒绝、composer 报错、甚至 php 解析失败都没人知道。

• 每条关键命令后加判断：if [ $? -ne 0 ]; then echo "pull failed" >&2; exit 1; fi
• PHP 脚本里打开错误报告：error_reporting(E_ALL); ini_set('display_errors', '0'); ini_set('log_errors', '1');，日志写到明确路径，比如 /var/log/deploy.log
• 推送时加 -v 看详细输出：git push -v origin main，注意看远程返回的 stderr 内容

Web 服务器缓存或 opcache 导致新代码不生效

部署脚本明明跑完了，浏览器还是旧页面——不是钩子错了，是 PHP opcache 没清，或者 Nginx 缓存了 index.html 的响应头。

• 部署完强制清除 opcache：opcache_reset()（需在 CLI 模式下可用）或重启 php-fpm：systemctl restart php8.2-fpm
• 检查 Nginx 是否开了 fastcgi_cache，临时关掉测试；或者确保响应头没带 Cache-Control: public, max-age=3600
• 上线前加个时间戳验证：file_put_contents('/var/www/html/deployed_at', date('c'));，浏览器直接请求这个文件看是否更新

实际跑通的关键，往往卡在“谁在哪个上下文里执行哪行命令”——不是逻辑多复杂，而是每个环节的执行主体（用户、shell、PHP SAPI）和路径假设，差一点就断链。

理论要掌握，实操不能落！以上关于《PHPGit自动部署失败怎么解决》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！