Git钩子是Git机制，与PHP版本无关；可用PHP编写但需shebang和可执行权限；推荐husky等工具管理，注意PHP路径、扩展依赖及工作目录问题。
PHP 项目里根本不能直接设 Git 钩子
Git 钩子是 Git 自己的机制，和 PHP 版本无关，也不是靠 php.ini 或 Composer 配置能开启的。你改了 PHP 版本（比如从 8.1 升到 8.3），不会自动触发或禁用钩子；反过来，钩子脚本里可以调用 PHP，但 PHP 本身不“管理”钩子。
常见误解是：以为在 composer.json 里写个 scripts 就等于 Git 钩子——其实那只是 Composer 的命令别名，只在运行 composer run 时生效，和 git commit 完全无关。
怎么在 .git/hooks/ 下写 PHP 钩子脚本
Git 钩子本质是可执行文件，放在项目根目录的 .git/hooks/ 下，文件名必须匹配钩子名（如 pre-commit、commit-msg）。想用 PHP 写，就得让系统能识别并执行它：
- 脚本第一行必须是 shebang，例如：
#!/usr/bin/env php - 文件需有可执行权限：
chmod +x .git/hooks/pre-commit - 脚本里用
$_SERVER['argv']拿参数，不要依赖交互式输入（钩子运行在非终端环境） - 返回非零退出码（如
exit(1)）会中断 Git 操作；返回 0 表示通过
示例 .git/hooks/pre-commit：
立即学习“PHP免费学习笔记（深入）”；
<pre class="brush:php;toolbar:false;">#!/usr/bin/env php
<?php
$output = [];
$returnCode = 0;
exec('php -l src/MyClass.php', $output, $returnCode);
if ($returnCode !== 0) {
echo "PHP 语法检查失败：\n" . implode("\n", $output);
exit(1);
}
exit(0);
用 husky 或 simple-git-hooks 替代手动写 .git/hooks
手写钩子容易被忽略、不进 Git（.git/hooks 默认不跟踪）、跨平台兼容差。更可靠的做法是用工具自动生成并同步钩子文件：
-
husky（Node 生态）：适合已有 npm 脚本的项目，通过npx husky add .husky/pre-commit "php test.php"注册 -
simple-git-hooks：轻量，只需在package.json里配"simple-git-hooks": { "pre-commit": "php ./scripts/pre-commit.php" } - 纯 PHP 项目可用
phing或自定义 Makefile，但得确保团队都装了对应运行时
注意：这些工具生成的钩子仍是 shell 脚本，只是帮你调用了 PHP 文件——真正的执行逻辑还在 PHP 里，版本兼容性得你自己控（比如别在 PHP 8.3 写 mysql_connect()）。
钩子里调用 PHP 命令的几个硬限制
不是所有 PHP 功能都能在钩子里安全用。Git 运行钩子时环境极简，PATH 可能不含你预期的 PHP 路径，也没有加载 .bashrc 或 ~/.zshrc：
- 务必用绝对路径调用 PHP，或在脚本开头显式指定：
/opt/homebrew/bin/php（macOS Homebrew）、/usr/bin/php（Linux） - 避免依赖扩展（如
pdo_mysql），除非确认 CI 和所有开发者机器都启用 - 别读写
$_ENV或getenv()里的敏感配置——钩子可能在无上下文环境跑，且日志默认不输出到终端 - 调试时加
file_put_contents('/tmp/hook-debug.log', print_r($_SERVER, true), FILE_APPEND);，比var_dump实用
最常被忽略的一点：钩子脚本的当前工作目录（getcwd()）是 Git 执行命令时的路径，不一定是项目根目录——如果从子目录运行 git commit，require 'config.php' 可能失败。建议统一用 dirname(__DIR__) 或 getcwd() + 显式拼接路径。
