启用--classmap-authoritative使Composer自动加载器完全依赖classmap,跳过PSR-4/PSR-0文件系统查找,提升生产环境类加载性能,但要求classmap必须完整覆盖所有可能加载的类,否则运行时报错。

开启 --classmap-authoritative 会让 Composer 生成的自动加载器完全依赖 classmap,跳过 PSR-4/PSR-0 的文件系统查找,显著提升生产环境下的类加载性能。
强制走 classmap,杜绝动态扫描
默认情况下,即使 classmap 已包含某个类,Composer 的 autoloader 仍会按 PSR-4 规则尝试在文件系统中查找(比如 App\Model\User → src/Model/User.php)。启用该参数后,autoloader 一旦在 classmap 中没找到类,就直接抛出 Class not found 错误,不再 fallback 到目录扫描。这消除了大量 file_exists() 和 is_file() 系统调用。
- 特别适合部署后代码不再变动的场景(如 Docker 镜像、PHP-FPM 容器)
- 对高频请求(如 API 接口)能减少每次请求约 5%~15% 的 CPU 时间(视类数量和目录深度而定)
要求 classmap 必须完整,否则运行时报错
它假设 classmap 覆盖了所有可能被加载的类——包括第三方包里通过非标准方式注册的类、运行时动态生成的类(如 Doctrine Proxy)、或未被自动发现的私有工具类。如果遗漏,应用启动或运行中就会报错。
标签: php laravel docker composer app 工具 栈 proxy 内存占用
还木有评论哦,快来抢沙发吧~