在PHP项目开发中,重复手动上传代码、更新服务器文件不仅浪费时间,还容易出现文件遗漏、版本不一致的问题,通过Git Hooks实现自动拉取代码是低成本且高效的自动化部署方案,适合中小团队和个人项目使用。

前置环境准备
在开始配置前,需要确保服务器满足以下条件:
- 已安装Git,并且服务器可以正常访问你的Git仓库(如果是私有仓库,需要提前配置SSH密钥)
- 服务器上已经部署好PHP运行环境,并且有对应的项目目录
- 拥有服务器的命令行操作权限,能够修改文件权限、执行脚本
配置服务器Git仓库
首先在服务器上初始化项目对应的Git仓库,假设你的项目目录是/var/www/php_project,执行以下命令:
# 进入项目目录 cd /var/www/php_project # 初始化Git仓库 git init # 关联远程仓库,替换为你的实际仓库地址 git remote add origin git@github.com:yourname/php_project.git # 设置仓库接受推送,避免后续拉取报错 git config receive.denyCurrentBranch ignore
编写Git Hooks脚本
Git Hooks是Git提供的钩子机制,我们可以在仓库收到推送时触发自动拉取脚本。进入仓库的.git/hooks目录,创建post-receive文件:
cd /var/www/php_project/.git/hooks # 创建post-receive钩子文件 touch post-receive # 赋予执行权限 chmod +x post-receive
编辑post-receive文件,写入以下内容:
#!/bin/bash # 项目目录路径 PROJECT_DIR="/var/www/php_project" # 进入项目目录 cd $PROJECT_DIR # 拉取远程master分支的最新代码,可根据需要修改为其他分支 git pull origin master # 可选:执行PHP相关的部署操作,比如清除缓存、更新依赖 # 例如使用composer更新依赖,需要确保服务器已安装composer # /usr/local/bin/composer install --no-dev # 输出部署完成日志 echo "代码自动拉取完成,部署成功"
配置权限与测试
需要注意Git拉取操作的执行用户权限,如果是通过Web服务触发(比如使用Web钩子间接调用),需要确保执行用户对项目目录有读写权限:
# 假设项目目录所有者是www-data(Nginx/Apache常用用户) chown -R www-data:www-data /var/www/php_project # 赋予目录读写权限 chmod -R 755 /var/www/php_project
完成配置后,可以在本地仓库修改代码并推送到远程仓库,然后到服务器项目目录查看文件是否已经更新,验证自动拉取是否生效。如果出现问题,可以查看/var/log下的相关日志,或者直接在服务器手动执行post-receive脚本排查错误。
注意事项
- 如果Git仓库是私有的,需要确保服务器上的用户已经配置了对应的SSH密钥,能够免密访问仓库
- 如果项目有依赖需要更新,可以在
post-receive脚本中添加对应的命令,比如composer、npm的执行命令 - 生产环境建议对自动部署的分支做限制,避免开发分支的代码误推到生产服务器
- 可以在脚本中添加错误判断,比如拉取失败时发送通知,方便及时排查问题