如何利用Composer的pre-autoload-dump事件进行代码生成？（元编程）

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，就能把元编程自然地嵌入依赖管理流程里，既轻量又可靠。