APCu autoloader 是 Composer 提供的加速机制，将类映射表缓存到 APCu 中以跳过每次请求的文件解析，仅适用于生产环境，需启用 APCu 扩展并配合 --optimize-autoloader 使用，不缓存类文件内容，只缓存类名到路径的映射。
APCu autoloader 是什么，值不值得开
Composer 的 apcu-autoloader 是一个可选的自动加载加速机制，它把 PSR-4/PSR-0 类映射表（即 vendor/composer/autoload_classmap.php 和 autoload_psr4.php 等）预存到 APCu 用户缓存中，跳过每次请求时重复解析和合并这些 PHP 数组文件的过程。
它只对生产环境有意义：本地开发通常无感知，反而可能因缓存未刷新导致类找不到；而高并发 CLI 或 FPM 场景下，能减少约 5–15% 的自动加载开销（取决于项目规模）。但注意：它不缓存类文件内容，只缓存“类名 → 文件路径”的映射关系。
- 必须启用 APCu 扩展（
extension=apcu.so），且apc.enabled=1、apc.shm_size足够（建议 ≥32M） - 不兼容 OPCache file cache 模式（
opcache.file_cache开启时，APCu 缓存可能被绕过） - 若使用 Docker，确保容器内 APCu 不是仅 CLI 模式（
apc.enable_cli=0是默认值，FPM 需单独配）
如何启用 apcu-autoloader（composer install/update 时）
启用方式不是改配置文件，而是通过 Composer 命令行参数或 composer.json 的 config 字段控制：
- 运行安装或更新时加
--apcu-autoloader参数：composer install --apcu-autoloader --no-dev --optimize-autoloader
- 或在
composer.json中固定配置（推荐用于 CI/CD）："config": { "apcu-autoloader": true, "optimize-autoloader": true, "classmap-authoritative": true }
关键点：
-
--apcu-autoloader必须与--optimize-autoloader同时使用，否则无效 -
classmap-authoritative可进一步提升性能（禁用动态扫描，要求所有类都在 classmap 中），但会破坏某些依赖于运行时动态注册的包（如部分 Laravel Service Providers） - 启用后，
vendor/autoload.php会多一段 APCu 读取逻辑，首次请求会写入缓存，后续直接命中
常见问题：类找不到、缓存不更新、APCu 未生效
这类问题几乎都源于环境配置或缓存生命周期管理不当：
-
Class not found错误常发生在部署后：APCu 缓存未清，但vendor/已更新，旧映射仍存在。解决方式是部署脚本中加入：php -r "apcu_clear_cache('user');" - 检查 APCu 是否真被加载：运行
php -m | grep apcu，并在 Web 环境中访问phpinfo()查看 APCu 段是否显示 “APCu Support => Enabled” - 使用
apcu_fetch('composer-apcu-autoloader')可手动检查缓存键是否存在（键名固定为composer-apcu-autoloader） - 如果用的是 PHP 8.0+ + OPCache + APCu，注意
opcache.save_comments=0可能导致某些注解解析失败——这不是 APCu 问题，但容易误判
APCu autoloader 和 OPCache 的协同关系
两者不冲突，但职责不同、生效层级不同：
- OPCache 缓存的是 PHP 文件的编译后 opcode，作用于所有 PHP 文件（包括
autoload.php自身） - APCu autoloader 缓存的是 Composer 生成的类映射数组（纯 PHP 数组），只影响
ClassLoader::findFile()这一环节
所以最优实践是：
- 同时开启 OPCache（
opcache.enable=1）和 APCu（apc.enabled=1） - 不要关闭 OPCache 来“腾出内存”给 APCu——它们共享同一块共享内存（
apc.shm_size是独立配置） - 若 APCu 内存不足（
apcu_cache_info()['memory_type'] === 'apc'返回 false），会出现静默降级（回退到普通 autoload），此时需调大apc.shm_size或减少缓存项（如禁用classmap-authoritative）
APCu autoloader 的实际收益很具体：它只省掉一次数组文件 require + 解析，所以项目越小，效果越不明显；而一旦类映射超过 10k 行，差异就会在火焰图里清晰可见。别指望它解决慢路由或数据库查询问题——它只管“类在哪”。
