post-install-cmd 默认失败中断安装是因为 composer 将其视为关键构建步骤，非0退出码会终止流程；解决方法是确保脚本最终返回0，如末尾加 exit(0)、用 sh -c 'cmd || true' 包裹或通过插件拦截。
Composer 的 post-install-cmd 脚本出错时，默认会中断整个安装流程，但很多团队其实只希望它“尽力而为”——比如生成缓存、触发通知、检查配置，失败了也不该让 composer install 报错退出。
为什么 post-install-cmd 默认失败会中断安装？
因为 Composer 将其视为“构建生命周期关键步骤”，只要脚本返回非 0 状态码（例如 PHP 脚本中 exit(1)、shell 命令执行失败），就会终止后续操作并报错：Script xxx handling the post-install-cmd event returned with error code 1。
这不是 bug，是设计行为。但实际中，你往往只需要“记录+忽略”，而非“阻断”。
让脚本失败不中断安装的三种实操方式
核心思路：确保脚本最终返回状态码 0，同时保留错误可见性。
- 在自定义 PHP 脚本末尾显式加
exit(0)，哪怕前面有异常或trigger_error()； - 在
scripts中用 shell 包裹命令，强制返回 0："post-install-cmd": ["sh -c 'php bin/check-config.php || true'"]
- 使用 Composer 插件（如
hirak/prestissimo不适用，但可自写）拦截事件并吞掉异常——不过多数场景没必要，过度复杂。
PHP 脚本里怎么安全捕获错误并静默处理？
别依赖 try/catch 就完事。Composer 执行的是 CLI 脚本，未捕获的致命错误（Fatal error）、语法错误、扩展缺失都会直接退出并返回非 0 状态。
推荐结构：
<?php
// bin/post-install-hook.php
register_shutdown_function(function () {
$error = error_get_last();
if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
error_log('[post-install-cmd] Fatal error: ' . $error['message'] . ' in ' . $error['file'] . ':' . $error['line']);
}
});
try {
// 你的逻辑，例如：生成路由缓存、检查 env 文件权限
if (!is_readable($_ENV['APP_ENV'] ?? '.env')) {
throw new RuntimeException('Missing or unreadable .env');
}
// ... do something
} catch (Throwable $e) {
error_log('[post-install-cmd] ' . get_class($e) . ': ' . $e->getMessage());
}
// 关键：无论成败，都 exit(0)
exit(0);
注意：register_shutdown_function 能兜住 parse/fatal 错误，但无法恢复执行；try/catch 处理运行时异常；最后的 exit(0) 是底线。
哪些情况仍建议让脚本失败并中断？
不是所有脚本都该“静默”。以下场景应保持失败传播：
- 生成密钥（
php artisan key:generate）失败 —— 应用将无法启动； - 数据库迁移预检（
php artisan migrate:status --dry-run）发现不兼容变更； - 校验签名文件（如
composer.lock对应的SIGNATURE）失败，涉及安全可信链。
判断标准很简单：如果该步骤的结果是后续命令/应用启动的**必要前提**，就别吞错误。
真正容易被忽略的点是：很多人改了脚本返回值，却忘了 CI/CD 流水线里还用 set -e 或类似机制捕获所有命令退出码——这时候即使 PHP 脚本 exit(0)，外层 shell 仍可能因 || 写法或管道错误中断。得通盘看执行上下文。
