php 8.2 本身不提供 git 部署能力,本质是用 git 管理源码并在目标环境正确运行 php 8.2 代码;部署失败主因是 post-receive 钩子中命令未用绝对路径、环境变量缺失、权限不足、错误未捕获及 opcache 未清理。

PHP 8.2 本身不提供 Git 部署能力,所谓“PHP8.2 Git部署”,本质是用 Git 管理 PHP 8.2 项目的源码 + 在目标环境正确运行 PHP 8.2 的代码。部署失败,90% 不是 PHP 版本问题,而是 Git 操作路径、权限、环境变量或 opcache 缓存没清理干净。
post-receive 钩子里的 php 命令为啥总找不到
Git 钩子运行在非交互式 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 - 加错误判断:每条关键命令后跟
if [ $? -ne 0 ]; then echo "xxx failed" >&2; exit 1; fi
部署后页面还是旧的,是不是 Git 没更新成功
更可能是 PHP opcache 没清,或者 Nginx 缓存了响应。Git 推送成功 ≠ 页面刷新生效。
- 部署脚本末尾加
opcache_reset()(需 CLI 模式下可用),或重启 FPM:systemctl restart php8.2-fpm - 检查 Nginx 是否启用了
fastcgi_cache,临时关掉测试 - 验证是否真生效:在部署脚本里加一行
file_put_contents('/var/www/html/deployed_at', date('c'));,浏览器访问该文件看时间戳 - 确认 Web 目录属主:git 用户要能写
/var/www/html,www-data 要能读
Git 怎么管好 PHP 8.2 项目的依赖和版本
Git 不管 PHP 解释器版本,只管代码;但项目必须声明并锁定运行时约束,否则协作即灾难。
-
composer.lock必须提交 —— 它才是依赖的真实快照,漏掉它,别人composer install装出来的包可能完全不同 -
.gitignore里确保有vendor/、.env、storage/logs/,且用git rm -r --cached vendor清理历史误提交 - 分支命名体现 PHP 约束:比如
main-php82、legacy-php74,而不是统一叫main - CI 中显式指定镜像:
image: php:8.2-cli,再手动装扩展:docker-php-ext-install mbstring pdo_sqlite xml
phpenv local 8.2.20 提交后队友切不了版本
phpenv local 生成的 .php-version 文件可 Git 跟踪,但它只是“提示”,不是魔法 —— 对方机器上必须已安装对应版本。
- 文件内容就是纯文本,例如:
8.2.20,提交到仓库没问题 - 队友 clone 后需先执行:
phpenv install 8.2.20(前提是他已装好 phpenv 和编译工具链) - 检查是否漏了 shell 初始化:
eval "$(phpenv init -)"要写进~/.zshrc或~/.bashrc,并source过 - Git hooks 里不能自动触发 phpenv 切换 —— hook 进程不继承你的 shell 环境,推荐用
setup.sh或 CI 显式安装
最常被忽略的一点:部署脚本里调用 composer install 前,得确认当前用户对 vendor/ 有写权限,且 composer.phar 在 $PATH 里或用了绝对路径;否则静默失败,连日志都不留。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











