shell_exec默认不工作是因为生产环境php.ini中disable_functions禁用了该函数；需删除列表中的shell_exec并重启php服务，而非web服务器。
shell_exec 必须启用，否则整个流程卡死在第一步——这不是权限问题，是 PHP 配置直接拦住执行链。
PHP 的 shell_exec 为什么默认不工作
绝大多数生产环境（尤其是宝塔、cPanel 或 Docker 官方镜像）会在 php.ini 的 disable_functions 里禁用 shell_exec、exec、system 等函数。哪怕你写了完整逻辑，shell_exec("git pull") 也会静默失败或返回空字符串。
检查方式：php -i | grep disable_functions
如果输出里含 shell_exec，就必须编辑 php.ini 删除它，并重启 PHP 服务（不是 Nginx/Apache）。
- 仅删
shell_exec不够：很多脚本会连带调用escapeshellarg或proc_open，建议一并确认是否被禁 - 宝塔用户注意：修改的是「PHP 设置」→「禁用函数」面板，不是直接改文件；改完要点「重载配置」
- 别用
ini_set("disable_functions", "")：运行时无法解除已禁用函数
Webhook 请求体解析必须匹配平台实际格式
GitHub、GitLab、Gitee 发送的 Webhook POST 数据格式不统一：
GitHub/GitLab 默认发 application/json，用 file_get_contents("php://input") 解析；
但部分私有 Git 服务（如 Gogs）可能发 application/x-www-form-urlencoded，此时 $_POST 才有效。
更关键的是签名验证字段名不同：
- GitHub 用
HTTP_X_HUB_SIGNATURE_256（SHA-256）或HTTP_X_HUB_SIGNATURE（SHA-1） - Gitee 用
HTTP_X_GITEE_TOKEN（明文 token） - GitLab 用
HTTP_X_GITLAB_TOKEN或HTTP_X_GITLAB_EVENT
硬写 $_SERVER['HTTP_X_HUB_SIGNATURE'] 而不判断来源平台，会导致验证永远失败——404 不是路径错，是签名校验跳过了。
Git 拉取失败的三个高频原因及对应命令
即使 PHP 能执行命令、Webhook 能进脚本，git pull 仍常卡住或报错。根本原因是 PHP 进程运行用户（如 www、nginx）和 Git SSH 密钥归属不一致。
-
Host key verification failed：PHP 用户首次连接 GitHub/Gitee 时没做 SSH host key 记录。解决：用 PHP 运行用户手动执行一次ssh -T git@github.com并确认 yes -
Permission denied (publickey)：SSH 私钥不在/home/www/.ssh/id_rsa，或权限不是600，或属主不是www。检查命令：ls -l /home/www/.ssh/和stat -c "%U %G %a" /home/www/.ssh/id_rsa -
error: Your local changes to the following files would be overwritten by merge：上一次部署中断导致工作区脏。必须加git reset --hard && git clean -fd清理，不能只靠pull
用 Shell 脚本封装比纯 PHP 更可靠
把所有 Git 操作、权限修复、日志记录塞进一个 deploy.sh，再由 PHP 调用它，比在 PHP 里拼接多条 shell_exec 更可控。原因很实际：
- 错误能集中捕获：
set -e让任意命令失败立即退出，不会“半拉子”更新 - 环境变量明确：
export GIT_SSH_COMMAND="ssh -o StrictHostKeyChecking=no"可绕过交互式确认 - 日志可追查：
exec >> /var/log/deploy.log 2>&1把整条执行流记下来，出问题不用猜哪步挂了 - PHP 只干两件事：校验签名 +
shell_exec("/bin/bash /path/to/deploy.sh")，逻辑极简，不易出错
真正容易被忽略的是：Shell 脚本里的路径必须写绝对路径（/usr/bin/git 而非 git），因为 PHP 的 shell_exec 默认没有 $PATH，which git 在脚本里也未必能用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
