Composer下载器插件必须实现DownloaderInterface，定义download()、remove()、cleanup()三方法；注册需在composer.json中配置allow-plugins和package类型repositories，并委托remoteFilesystem拉取、dispatch事件、避免内存溢出与并发冲突。
Composer下载器插件必须实现DownloaderInterface
Composer不接受任意回调或钩子来接管下载，唯一合法入口是实现DownloaderInterface。它定义了download()、remove()和cleanup()三个方法，其中download()是核心——你得在这里处理包解压、校验、缓存写入等全部逻辑。漏掉cleanup()会导致临时文件堆积；如果remove()没清空vendor下的对应目录，后续composer install可能复用脏数据。
常见错误是直接在download()里用file_get_contents()拉zip再unzip，但这样跳过了Composer内置的RemoteFilesystem重试、HTTP头校验、断点续传能力。正确做法是委托给$this->io和$this->remoteFilesystem做基础拉取，你只负责后续解包与路径映射。
注册自定义下载器要改composer.json的repositories和config
仅写插件类不够，Composer不会自动发现。必须在项目根目录的composer.json中显式声明：
{
"config": {
"fxp-asset": {"enabled": false},
"allow-plugins": {
"your-vendor/your-downloader-plugin": true
}
},
"repositories": [
{
"type": "package",
"package": {
"name": "private/vendor-package",
"version": "1.0.0",
"dist": {
"url": "https://your-cdn.example.com/pkg-1.0.0.zip",
"type": "zip"
}
}
}
]
}
关键点：
-
allow-plugins必须精确匹配插件包名，且值为true（不能是"*"） -
repositories里type设为"package"才能绕过Packagist，默认"composer"类型仓库无法触发自定义下载器 -
dist.type必须与你的下载器支持的类型一致（如"zip"），否则Composer会fallback到默认ZipDownloader
download()里必须调用$eventDispatcher->dispatch()通知进度
不发事件会导致composer install -v卡在“Downloading...”不动，或者进度条永远100%但实际没完成。Composer CLI依赖PackageEvents::PRE_PACKAGE_INSTALL和PackageEvents::POST_PACKAGE_INSTALL来刷新状态。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 在
download()开头dispatchPackageEvents::PRE_PACKAGE_INSTALL - 解压完成后dispatch
PackageEvents::POST_PACKAGE_INSTALL - 事件对象必须传入
$package实例（PackageInterface）和$targetDir（目标路径），否则后续脚本钩子拿不到上下文 - 别在
download()里做耗时校验（如全量SHA256比对），应拆到install()阶段——下载器只管“拿到可用文件”，校验失败应抛RuntimeException而非静默跳过
调试下载器时COMPOSER_MEMORY_LIMIT和-vvv缺一不可
下载器崩溃常表现为PHP Fatal error: Allowed memory size exhausted，尤其处理大zip时。这不是代码问题，而是Composer默认限制1.5G内存，而解压过程会双倍占用（源流+目标文件系统缓存）。
快速验证方式：
- 运行前加环境变量：
COMPOSER_MEMORY_LIMIT=-1 composer install -vvv -
-vvv会输出每一步调用的下载器类名和download()参数，确认是否命中你的实现 - 若仍失败，在
download()开头加error_log("Downloader called for {$package->getName()}");，日志会出现在php://stderr，-vvv模式下可见 - 注意：插件类的
autoload必须在composer.json里用"psr-4"正确声明，否则-vvv连类都找不到，直接fallback到默认下载器
真正难缠的是并发安装场景——多个包同时触发你的download()，临时目录冲突或锁文件竞争容易被忽略。别依赖sys_get_temp_dir()，改用VendorDir . '/.composer-download-tmp/' . uniqid()更稳妥。
