Composer中文镜像环境下Composer脚本执行预处理技巧-composer-PHP中文网

pre-install-cmd在composer 1.10+/2.0+中可用，需置于composer.json的scripts顶层、格式为数组且未启用--no-scripts；它在依赖解析前触发，不加载autoloader，无法require vendor/autoload.php。

composer中文镜像环境下composer脚本执行预处理技巧

中文镜像只解决下载慢，不改变脚本执行逻辑；预处理脚本能否跑、何时跑、为何不跑，和镜像无关，全看 composer.json 配置、命令参数、执行上下文是否匹配。

pre-install-cmd 和 pre-update-cmd 真的能用吗

能，但有硬性前提：Composer 1.10+ 或 2.0+，且没加 --no-scripts。这两个钩子在依赖解析开始前就触发，适合做环境检查、配置生成、锁文件校验等“安装前守门人”动作。

必须写进 composer.json 的 scripts 字段顶层，格式严格："pre-install-cmd": ["php scripts/check.php"]
如果项目用了 composer install --no-scripts（CI 常见），那它根本不会被调用，不是镜像问题，是参数拦住了
验证是否注册成功：运行 composer run --list，能看到 pre-install-cmd 出现在列表里（不是所有版本都显示，但存在即有效）
别指望它替代 post-autoload-dump——前者在下载前，后者在 autoload 生成后，阶段完全不同

脚本里 require vendor/autoload.php 总报 Class not found

Composer 执行脚本时默认不加载项目 autoloader，这是设计行为，不是 bug。你得自己引，而且路径不能错。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

脚本若放在 scripts/ 目录下，第一行必须是：require __DIR__ . '/../vendor/autoload.php';
写成 require 'vendor/autoload.php'; 或 include __DIR__ . '/vendor/autoload.php'; 都会失败——前者相对路径错，后者用错函数
如果 vendor/ 还没生成（比如第一次 install），pre-install-cmd 里就不能依赖任何 vendor 类，只能用 PHP 内置函数或系统命令
想安全调用 Laravel 的 Artisan 或 Symfony 的 Console？先确保 composer dump-autoload 已执行过，且类已声明在 autoload 或 autoload-dev 中

CI 中 pre-install-cmd 没输出、也没生效？查这三处

镜像加速了包下载，但不会让脚本自动变可靠。CI 环境下静默失效最常见于权限、路径、缓存三重干扰。

HOME 环境变量不对：全局镜像配置写进了 /root/.composer/config.json，但 CI runner 以 runner 用户运行，读的是 /home/runner/.composer/config.json，pre-install-cmd 虽然能跑，但可能因配置缺失导致后续依赖拉取失败，看起来像脚本没起作用
缓存 key 没带镜像标识：复用的 ~/.composer/cache 是按源地址哈希的，混用阿里云和 packagist.org 缓存会导致 corrupted cache file，脚本可能卡在“Resolving packages…”阶段，根本进不到 pre-* 钩子
脚本本身有 exit code 非 0：比如 php scripts/check.php 里写了 exit 1 表示校验失败，Composer 默认会中止整个 install 流程，但日志可能只显示 “Script xxx handling the pre-install-cmd event returned with error code 1”，容易被忽略

临时换镜像时 pre-install-cmd 还生效吗

生效，但要注意优先级链。临时 --repository-url 只影响包下载地址，不影响脚本注册与触发时机。

composer install --repository-url=https://mirrors.aliyun.com/composer/ → pre-install-cmd 照常运行，只是后续下载走阿里云
但如果 composer.json 里 repositories 字段写了已下线的私有源，pre-install-cmd 还没跑完，Composer 就卡在“Trying private repo... timeout”，你会误以为脚本没触发
想验证脚本逻辑是否独立于镜像：先删掉 vendor/ 和 composer.lock，再用 composer install --no-network --no-scripts，这样连网络请求都跳过，只跑脚本，最干净