PHP项目Git实践关键在规避环境与流程陷阱：GitFlow适合多版本发布，TBD适合持续交付；phpenv需正确配置.shims和.shell初始化；Webhook调用Git应优先选php-git库防注入；pre-commit仅本地提醒，质量卡点应在CI或服务端钩子。
PHP项目用Git不是“会不会”的问题，而是“怎么不踩坑”的问题——尤其当团队开始协作、CI/CD介入、本地PHP环境多版本共存时，基础git add/git commit根本压不住场。
GitFlow vs Trunk-Based Development：PHP项目该选哪个？
别被模型名字吓住，关键看你的发布节奏和团队规模。
- GitFlow适合有明确发布周期（如每月一版）、需长期维护多个线上版本（v1.2、v2.0）的PHP项目；它强制区分
develop、release/*、hotfix/*分支，但分支太多容易 merge 冲突，git merge --no-ff成了日常操作 - Trunk-Based Development（TBD）更适合持续交付场景：所有人向
main（或trunk）提交，靠自动化测试+短生命周期特性开关（feature toggle）兜底；PHP项目若已接入phpunit+psalm+php-cs-fixer流水线，TBD反而更轻量 - 新手最容易错的是“半套GitFlow”：建了
feature/xxx却直接git push origin main，或把hotfix分支合并进develop又忘了同步回main，导致线上补丁漏发
phpenv + Git 协作时，.php-version 文件为什么常失效？
这不是Git的问题，是shims机制和shell初始化没对齐。常见现象：进项目目录后php -v还是系统默认版本，git status却显示正常。
-
.php-version文件必须放在项目根目录，内容只能是纯版本号（如8.2.20），不能带php-前缀或空格 - 执行
which php，输出必须是~/.phpenv/shims/php；如果不是，说明eval "$(phpenv init -)"没写进~/.zshrc（Zsh用户）或~/.bashrc（Bash用户），且未source生效 - Git操作本身不感知phpenv，但CI脚本或部署钩子（如
post-receive）里若调用php artisan migrate，就必须先cd /path/to/project && phpenv local 8.2.20，否则可能因PHP版本不匹配报ParseError
用PHP代码调用Git命令，shell_exec()和php-git库怎么选？
核心权衡点：可控性 vs 安全性。Webhook自动部署、后台任务触发Git拉取这类场景，选择逻辑必须明确。
立即学习“PHP免费学习笔记（深入）”；
- 直接
shell_exec('git pull origin main 2>&1')最简单，但输入若来自URL参数（如?branch=user_input），没过滤就等于给攻击者开了rm -rf /通道；必须用escapeshellarg()包裹所有动态参数 -
php-git库（如composer require kbjr/gitlib）用面向对象方式封装，$repo->pull('origin', 'main')内部已做路径校验和权限隔离，适合集成进Laravel Command或ThinkPHP命令行工具 - 注意
php.ini中disable_functions是否禁用了shell_exec——很多生产环境会关掉，此时php-git是唯一可行路径；但它不支持git submodule update --init这类复合操作，得回退到exec()补位
Git hooks里跑PHP检查，pre-commit为什么总被绕过？
因为钩子只在本地生效，而git push时远程仓库根本不会执行你的pre-commit。真正能卡住质量的是pre-receive钩子（服务端）或CI中的before_script（GitLab CI）。
- 本地
pre-commit可加PHP语法检查：php -l app/Http/Controllers/*.php，但开发者git commit --no-verify就能跳过——它只起提醒作用 - 想强制拦截，必须在Git服务器（如GitLab自建实例）配置
pre-receive钩子，或更现实的做法：在.gitlab-ci.yml里写before_script: - composer install --no-dev+script: - vendor/bin/phpcs - PHP项目特有的坑：
pre-commit里调用php-cs-fixer fix自动格式化，但如果团队IDE设置不同（如缩进用4空格 vs tab），会导致每次commit都产生无意义diff，建议统一用.editorconfig而非钩子解决
Git工作流的复杂度不在命令本身，而在PHP运行环境、权限链路、CI阶段和人为习惯的交叉点上。一个.php-version文件配错，可能让git pull后的composer install直接失败；一次pre-receive钩子没写好，就等于把代码质量闸门拆了。这些细节，比记住git rebase -i的7种操作模式重要得多。
