Composer自动加载黑盒火焰图调优-composer-PHP中文网

composer dump-autoload -o 没提速是因为它不自动生成 autoload_classmap.php，仅刷新 psr-4 映射；真正生效需在 composer.json 中显式配置 "classmap" 路径、执行 composer install --no-dev --optimize-autoloader --classmap-authoritative 重建映射，并验证 vendor/composer/autoload_real.php 是否调用 addclassmap。

composer自动加载黑盒火焰图调优

composer dump-autoload -o 为什么没提速？

不是命令没跑，而是它根本没生成有效的 autoload_classmap.php。默认只刷新 autoload_psr4.php 和 autoload_static.php，classmap 文件要么为空，要么只有零星几个类——因为你的项目没显式配置 "classmap"，也没把测试目录、工具类目录写进 autoload 或 autoload-dev 里。

常见漏扫路径：tests/、app/Providers/（如果没在 PSR-4 中声明）、src/Helpers/（文件名含下划线或点号，如 Str_Helper.php）；这些文件压根不会被扫描进 classmap。

运行 composer dump-autoload -o 后，先检查 vendor/composer/autoload_classmap.php 是否存在且体积 >100KB
打开 vendor/composer/autoload_real.php，搜索 addClassMap —— 如果没这行，说明 classmap 没被加载
确认 composer.json 的 autoload 段至少有一项 "psr-4" 或 "classmap"，否则 -o 不触发任何 classmap 构建

怎么让 classmap 真正覆盖所有运行时类？

别指望 Composer 自动猜路径。它只扫你明确定义的目录，且只收录符合命名规范的 .php 文件：类名必须与文件名严格一致（Foo.php 含 class Foo），不含 eval()、匿名类、class_alias() 的文件会被跳过。

最稳的做法是收口：在 composer.json 中显式列出所有可能用到类的目录，哪怕它们本该走 PSR-4：

Discussion Composer

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

下载

"autoload": {
  "classmap": ["src/", "app/", "tests/", "lib/"],
  "psr-4": {}
}

删掉冗余的 psr-4 映射，避免双重维护；classmap 是扁平查找，比拼接路径 + file_exists() 快得多
加 --classmap-authoritative 后，tests/ 目录若没写进 autoload-dev，测试就会直接报 Class not found
CI/CD 中跑 composer install --optimize-autoloader --no-dev，确保新依赖里的类也被扫进 classmap

APCu autoloader 缓存为何不生效？

它不缓存类文件内容，只缓存“类名 → 路径”的映射数组。但这个缓存要起效，得同时满足三个条件：APCu 扩展启用、apc.stat=0、且 composer install 时用了 --apcu-autoloader（dump-autoload 不支持该参数）。

apc.enable_cli=0 是默认值，Docker 或 FPM 环境下必须显式设为 1，否则 APCu 只在 CLI 模式可用
opcache.file_cache 开启时会绕过 APCu，二者冲突；生产环境建议关掉 opcache.file_cache，只用 OPCache bytecode 缓存
部署后必须清 APCu 用户缓存：php -r "apcu_clear_cache('user');"，否则旧 classmap 映射还在，新类找不到

火焰图里 `is_dir()` 和 `file_exists()` 占比高怎么办？

这是 PSR-4 fallback 逻辑在作祟：即使开了 --optimize-autoloader，只要没加 --classmap-authoritative，Composer 还是会在 classmap 查不到时，按命名空间规则逐层 is_dir() 和 file_exists()。一个 Laravel 请求里这类调用常达 300+ 次。

加 --classmap-authoritative 后，这些系统调用基本归零——但它要求 100% 类静态可发现，动态生成类（如某些 ORM 代理、Laravel 的 class_exists() 探测）会直接失败
若必须保留动态能力，改用 --apcu-autoloader：首次查不到时仍会走文件系统，但结果缓存到 APCu，后续请求直接命中
别忽略 OPcache：确保 opcache.enable=1 且 vendor/autoload.php 被缓存（查 opcache_get_status()['scripts']），否则 classmap 数组每次都要重新 parse

真正卡住的往往不是 classmap 查找本身，而是 classmap 文件太大（几 MB）导致 OPcache 加载慢，或者 APCu 共享内存不足（apc.shm_size 小于 64M）引发频繁淘汰。