PHP自动拉取Git代码部署需解决权限、Shell限制及Git配置问题，方法包括：一、exec函数直接调用；二、proc_open精细控制；三、独立CLI脚本规避Web限制；四、Git Hook推送即部署；五、Symfony Process组件面向对象管理。
如果您希望在服务器上通过PHP脚本自动拉取Git仓库最新代码并完成部署，则可能是由于PHP进程权限、Shell执行限制或Git环境配置不一致导致命令调用失败。以下是实现该功能的具体方法：
一、使用exec函数执行Git命令
该方法直接调用系统Shell，适合部署环境已配置好Git且Web服务器用户（如www-data）具备对应仓库读写权限的场景。
1、确保PHP配置中未禁用exec函数，检查disable_functions列表是否包含exec。
2、确认Web服务器运行用户对目标项目目录具有读写权限，并能访问Git二进制文件路径。
立即学习“PHP免费学习笔记（深入）”；
3、在PHP脚本中构造并执行Git命令，例如：exec('cd /var/www/myapp && git pull origin main 2>&1', $output, $returnCode)。
4、检查$returnCode返回值，0表示成功，非0需结合$output排查具体错误。
二、使用proc_open函数精细控制Git执行过程
该方法可捕获标准输出、标准错误及实时反馈，适用于需要监控拉取进度或处理认证交互（如SSH密钥）的部署流程。
1、构建描述符数组，指定stdin、stdout、stderr的管道流向。
2、调用proc_open启动git pull命令，例如：proc_open('git pull origin main', $descriptorspec, $pipes, '/var/www/myapp', $_ENV)。
3、使用stream_get_contents依次读取$ pipes[1]（stdout）和$ pipes[2]（stderr）内容。
4、调用proc_close获取退出状态码，必须显式关闭所有管道句柄以避免资源泄漏。
三、封装为独立可执行PHP CLI脚本
将部署逻辑从Web上下文剥离，改由系统定时任务或钩子触发，规避Web服务器权限与超时限制。
1、在脚本首行添加Shebang声明：#!/usr/bin/env php。
2、使用chdir切换至项目根目录，再调用system或passthru执行Git命令。
3、通过argv接收分支名参数，例如：php deploy.php --branch=develop。
4、在脚本开头加入set_time_limit(0)，防止长连接拉取大仓库时被PHP超时中断。
四、配合Git Hook实现推送即部署
在Git远程仓库服务器端配置post-receive钩子，当有新提交推送到指定分支时，自动触发本地PHP部署脚本。
1、进入裸仓库hooks目录，编辑post-receive文件，添加可执行权限。
2、在钩子中调用PHP脚本，例如：/usr/bin/php /opt/deploy/deploy.php。
3、PHP脚本内通过$_SERVER['SSH_CONNECTION']或环境变量识别触发来源，避免被非授权推送意外触发。
4、使用git --work-tree和--git-dir参数指定工作树路径，确保钩子在裸仓库中也能正确更新网站目录。
五、使用Symfony Process组件管理Git进程
该方法提供面向对象接口与异常处理机制，适合已引入Composer依赖管理的项目。
1、通过composer require symfony/process安装组件。
2、实例化Process对象并传入Git命令数组：new Process(['git', 'pull', 'origin', 'main'])。
3、设置工作目录为项目路径：$process->setWorkingDirectory('/var/www/myapp')。
4、调用run()执行并检查isSuccessful()返回值，失败时可通过getErrorOutput()获取详细报错信息。
