先看 composer install -v 或 update -v 的完整输出，错误根源在最上面几行；undefined index: _composer 是因脚本误读 $_post（钩子无 http 上下文），应改用 $_post['_composer'] ?? null；脚本不执行需检查 scripts 是否在根层级、事件名是否为全小写中划线格式、是否被 --no-scripts 禁用或 composer.json 格式错误。
脚本报错时，先看 composer install -v 或 composer update -v 的完整输出，错误根源几乎总在堆栈最上面几行——不是 Composer 报错，而是你写的 PHP 脚本或 shell 命令崩了。
报错显示 Undefined index: _composer 怎么办
这不是 Composer 的错，是你的 PHP 脚本在钩子中裸读 $_POST['_composer'] 导致的 notice。post-install-cmd、post-update-cmd 等钩子根本不会收到 HTTP 请求，$_POST 永远为空。
- 常见位置：你在
composer.json的scripts里调用了类似"php build/config.php"的文件，而该文件写了$val = $_POST['_composer']; - 快速修复：改用空合并操作符防御性读取，例如
$val = $_POST['_composer'] ?? null;或更严格地$val = trim($_POST['_composer'] ?? '') ?: null; - 别试图在钩子里依赖
$_POST或$_SERVER的 Web 上下文变量——它们不存在，也不该存在
脚本完全不执行，连 echo 都没输出
Composer 对钩子配置极其敏感，静默失败是常态，不是 bug。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
scripts是否在composer.json根层级，嵌套在extra或config里会直接被忽略 - 确认事件名拼写：必须是
post-install-cmd（全小写 + 中划线），postinstall-cmd、PostInstallCmd、after-install全部无效 - 查是否被禁用：
composer install --no-scripts会跳过所有钩子，CI 环境常默认启用；运行前加-v看日志里有没有Executing script行 - 验证 composer.json 格式：
composer validate可发现语法错误导致整个 scripts 段被丢弃
脚本执行了但中途退出，后续命令不运行
数组形式的脚本列表默认“遇到非零退出码就中断”，不像 shell 脚本那样自动继续。
- 命令写成数组更安全，但每个条目独立执行：
"post-install-cmd": ["php artisan config:clear", "php bin/generate-config.php"] - 如果某条命令可能失败（比如缓存目录不存在），又不想阻断后续，可显式忽略退出码：
"php artisan config:clear || true"，但仅限调试或非关键步骤 - 避免单字符串写法：
"post-install-cmd": "php artisan key:generate && php artisan config:clear"容易因引号、空格、shell 特殊字符解析失败 - 注意路径问题：Composer 执行脚本时当前工作目录是
composer.json所在目录，所有相对路径都基于此
本地能跑，CI/CD 里不生效
环境差异是最大干扰源，不是配置本身有问题。
- CI 常用 shallow clone，导致
.git目录缺失，某些依赖判断逻辑（如版本推导）失效，间接影响钩子行为 - vendor/ 缓存未清空，
post-install-cmd因 vendor/ 已存在而不触发；改用post-update-cmd或加--no-cache更可靠 - PHP 扩展缺失：脚本里用了
mbstring或xml，但 CI 镜像没装，报Call to undefined function—— 运行前加php -m检查 - 权限问题：Linux CI 中
rm -rf runtime/cache可能因权限失败，Windows 用户则rm不识别；统一用 PHP 脚本清理更稳妥
真正难排查的从来不是语法错误，而是钩子执行时机和环境假设之间的错位：你以为它在“安装后”运行，其实它只在“vendor 重建时”运行；你以为 $_POST 有值，其实它压根没经过 Web Server。盯住 -v 输出里的实际执行路径和退出码，比猜更有效。
