APCu autoloader必须与--optimize-autoloader联用才生效，它仅缓存类名到路径的映射表（非类文件内容），依赖APCu扩展启用且仅在PHP-FPM环境下有效，CLI需额外配置apc.enable_cli=1。
apcu-autoloader 不是独立开关，必须和 --optimize-autoloader 一起用
单独加 --apcu-autoloader 没效果。Composer 会直接忽略它，因为 APCu 缓存只作用于已生成的类映射表（autoload_classmap.php 或 autoload_static.php），而这张表只有在启用 --optimize-autoloader（或 -o）时才会被构建出来。
常见翻车场景：
- CI 脚本里只写
composer install --apcu-autoloader，结果缓存没写入，APCu 里查不到任何 key - 本地开发误开
"apcu-autoloader": true但没配"optimize-autoloader": true，vendor/composer/autoload_classmap.php根本不存在，自动加载器连 fallback 都不走，直接报错
APCu 缓存的是什么？不是类文件，只是“类名 → 路径”的映射
--apcu-autoloader 不缓存 PHP 类源码，也不解析 require 或 include；它只把 Composer 生成的 classmap（即 class => /path/to/file.php 这种数组）序列化后存进 APCu 共享内存。后续请求调用 ClassLoader::findFile() 时，直接从 APCu 读这个映射，跳过 file_exists() 和字符串拼接逻辑。
这意味着：
- 类文件内容变更（比如改了方法体）不影响 APCu 缓存，只要路径没变，就能命中
- 类被移动或重命名后，必须重新运行
composer dump-autoload --apcu-autoloader或composer install --apcu-autoloader --optimize-autoloader，否则仍按旧路径加载 - 不加速
"files"类型的全局函数加载（如"files": ["app/Helpers/functions.php"]），这类逻辑绕过 classmap，APCu 完全不介入
PHP-FPM 下才真正生效，CLI 模式需额外配置
APCu 在 PHP-FPM 进程间共享，所以 Web 请求能复用同一份缓存；但 CLI 模式默认禁用 APCu（apc.enable_cli=0），导致 composer install 命令本身无法写入缓存——你看到 vendor/autoload.php 多了一段 APCu 读取逻辑，但首次请求仍要重建。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须确认以下三点：
-
extension=apcu.so已加载，且apc.enabled=1 - FPM pool 的 php.ini 中显式设置
apc.enable_cli=0（保持默认即可），但确保 FPM worker 进程里apc.enable_cli不生效 —— 它只影响 CLI，FPM 用的是apc.enabled - Docker 环境下，别用
php:alpine默认镜像，它常只装 CLI 版 APCu；要用php:fpm镜像并确认apcu.so在 FPM 的php.ini里启用
缓存冲突和内存挤占是线上最容易忽略的坑
APCu 是进程共享、无命名空间的缓存，默认所有 PHP 应用共用一个 key 空间。如果多个项目部署在同一台服务器的同一个 PHP-FPM pool 下，它们的 classmap 会互相覆盖 —— A 项目更新后，B 项目可能加载到 A 的旧路径。
解决方式只有两个：
- 给每个项目设唯一 namespace：
ini_set('apc.namespace', 'myapp_v2');（需在vendor/autoload.php加载前执行） - 或者更稳妥：为每个项目分配独立的 FPM pool，并在 pool 配置中用
php_admin_value[apc.namespace] = myapp_v2 - 低内存服务器（
apc.shm_size ）上，大项目的 classmap 可能占满 APCu，导致 opcache 或其他用户缓存被踢出；建议用 <code>apcu_cache_info()监控mem_size和num_entries
APCu 缓存不会自动失效，也没有 TTL；它的生命周期就是 PHP 进程重启或手动 apcu_clear_cache()。别指望它像 Redis 那样自动过期 —— 部署新版本时，要么重启 FPM，要么在 deploy 脚本里加一行 php -r "apcu_clear_cache();"。
