pre-autoload-dump事件在vendor/autoload.php生成前触发，仅于composer install/update或dump-autoload时执行，适合生成可被自动加载识别的代码；需在composer.json中注册脚本并确保类可加载。
Composer 的 pre-autoload-dump 事件发生在自动加载文件（vendor/autoload.php）生成之前，是执行代码生成任务的理想时机——它确保生成的代码能被后续的 autoloader 正确识别和加载，且只在依赖变更或 dump-autoload 时触发，避免重复开销。
理解 pre-autoload-dump 的触发时机
该事件不是在每次脚本运行时触发，而是在以下情况发生时执行：
- 运行
composer install或composer update - 显式执行
composer dump-autoload - 任何导致 Composer 重新生成
autoload_static.php或ClassLoader映射的操作
此时，composer.json 中已解析完毕，包路径、PSR-4 映射、类名规则都已确定，适合基于配置生成类、接口或代理代码。
在 composer.json 中注册生成脚本
在 composer.json 的 scripts 段中声明一个 PHP 脚本，并绑定到 pre-autoload-dump：
"scripts": {
"generate:stubs": "My\\Builder\\StubGenerator::run",
"pre-autoload-dump": [
"@generate:stubs"
]
}
注意：脚本必须是可调用的（静态方法、闭包或命令行可执行文件），且需确保其类能被当前 Composer 环境加载（建议放在 src/ 下并正确配置 PSR-4）。
编写生成逻辑（以生成 DTO stubs 为例）
在 src/Builder/StubGenerator.php 中实现：
namespace My\\Builder;
use Composer\Autoload\AutoloadGenerator;
use Composer\Script\Event;
class StubGenerator
{
public static function run(Event $event)
{
$vendorDir = $event->getComposer()->getConfig()->get('vendor-dir');
$targetDir = $vendorDir . '/my-stubs';
// 确保目录存在
if (!is_dir($targetDir)) {
mkdir($targetDir, 0755, true);
}
// 基于已知接口或注解生成 DTO 类（示例：为每个 @dto 标记的 interface 生成实现）
$interfaces = glob(__DIR__ . '/../Contracts/*.php');
foreach ($interfaces as $file) {
$content = file_get_contents($file);
if (preg_match('/@dto\s+([a-zA-Z0-9_\\\\]+)/', $content, $m)) {
$name = $m[1];
$className = $name . 'Stub';
$code = "getIO()->write("✅ Generated stubs in {$targetDir}");
}
}
关键点：
- 使用
Event对象获取Composer实例和 IO 接口 - 生成的文件应放在 Composer 能扫描到的位置（如
vendor/子目录或项目src/），并确保其命名空间与 autoload 配置匹配 - 若生成代码需被自动加载，应在
composer.json的autoload或autoload-dev中提前声明对应路径（例如："My\\Stub\\": "vendor/my-stubs/"）
调试与验证技巧
由于事件在 autoloader 生成前运行，调试时容易遇到“类未找到”错误。推荐做法：
- 先用
composer dump-autoload --no-scripts排查是否为生成脚本本身的问题 - 在脚本开头加
error_log("Running generator...")并检查php -d error_log=php://stderr composer dump-autoload输出 - 生成后手动运行
composer dump-autoload -v，观察 autoload 映射是否包含新类 - 用
composer show --platform确认生成目录是否被纳入扫描范围
基本上就这些。用好 pre-autoload-dump，就能把元编程自然地嵌入依赖管理流程里，既轻量又可靠。
