必须用 composer install --optimize-autoloader --no-dev,否则 frankenphp 的常驻进程优势会被 composer 自动加载拖垮;因其 worker 模式下进程长存,未优化时每次类加载都触发磁盘 i/o 和文件解析,而该命令生成扁平 classmap 实现零开销内存查找,并裁剪 dev 依赖与冗余 autoload 文件。

直接结论:必须用 composer install --optimize-autoloader --no-dev,否则 FrankenPHP 的常驻进程优势会被 Composer 自动加载拖垮。
为什么自动加载优化对 FrankenPHP 特别关键
FrankenPHP 的 worker 模式下,PHP 进程长期存活,所有请求复用同一份内存空间。但默认的 Composer 自动加载是基于 classmap 查表 + include 动态加载,每次 new 一个类都要走一次文件系统查找和 PHP 解析 —— 在高并发下,这会变成 I/O 和 CPU 的双重热点。
而 --optimize-autoloader 会生成扁平化的 vendor/composer/autoload_classmap.php,把所有类名到文件路径的映射硬编码成 PHP 数组,class_exists() 或 new 实例时直接查数组,零磁盘 I/O、无正则匹配、无文件 stat。
- 未优化时,1000 QPS 下可能产生数万次
stat()系统调用 - 优化后,类加载退化为纯内存哈希查找,实测 Symfony 应用首字节时间(TTFB)下降 15–25%
- 该优化只对 PSR-4/PSR-0 命名空间有效;若项目混用
files加载(如全局函数),需额外确认是否被包含进 classmap
composer install 和 composer dump-autoload 的区别与陷阱
很多人在部署时只跑 composer dump-autoload --optimize,但这不等于生产就绪 —— 它只重写 autoload 文件,不清理 vendor/autoload.php 中的 dev-only 包、不触发 autoload_files.php 的裁剪,更不会禁用开发专用 autoloader 分支(如 autoload-dev)。
-
composer install --no-dev --optimize-autoloader才是完整流程:跳过require-dev、删掉 dev 相关 autoload 规则、强制生成 classmap、且不写入vendor/composer/autoload_psr4.php等冗余文件 - 若项目用了
composer config -g store-auths false或私有包仓库,务必确保构建环境能访问对应源,否则install会卡住或降级为不带 classmap 的 fallback 模式 - 执行后检查
vendor/composer/autoload_classmap.php是否存在且非空;若只有几行或全是注释,说明 classmap 生成失败(常见于 symlink 未解引用或路径权限问题)
OPcache 预加载必须配合 classmap 使用
FrankenPHP 支持 OPcache 预加载(opcache.preload),但它要求预加载脚本里所有 require 的文件必须「绝对路径明确、无条件执行」。而默认的 Composer autoloader 依赖运行时判断,无法直接 preload。
- 启用
--optimize-autoloader后,可安全地让预加载脚本require vendor/composer/autoload_classmap.php,再require所有核心框架类(如vendor/symfony/http-kernel/Kernel.php) - 不要尝试预加载
vendor/autoload.php本身 —— 它内部含条件逻辑,PHP 会拒绝 preload 并报Cannot preload because the script was loaded via a relative path - 预加载后,用
opcache_get_status()['preload_statistics']验证类是否已进共享内存;若scripts_memory_usage为 0,说明预加载未生效(常见于 php.ini 中opcache.preload路径写错或权限不足)
真正卡吞吐量的从来不是 PHP 解释器本身,而是每次请求都在重复做同一件事:找类、读文件、解析语法。FrankenPHP 把进程留住了,但如果你没让 Composer 把类路径“焊死”在内存里,那它就只是个更贵的 PHP-FPM。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











