APCu在PHP 8.5.5中需手动安装并正确配置才能生效；常见失败原因包括未启用extension、CLI与FPM配置不一致、未重启对应进程、apc.enabled/apc.enable_cli未设为1，以及内存限制过小导致apcu_store静默失败。
apcu_store() 调用失败、composer dump-autoload -o --apcu 无效果、phpinfo() 里搜不到 APCu —— 这些问题基本都卡在同一个环节：PHP 8.5.5 默认不带 APCu，装了扩展但没配对配置，或配了但没重启对应进程。
确认 APCu 扩展是否真正加载成功
别信“我装过了”，得看 PHP 实际加载的是哪个 php.ini、哪个进程用了它。
-
php -m | grep apcu只能验证 CLI 模式是否加载；Web 请求走的是 FPM 或 CGI 进程，必须单独查：php-fpm -i | grep apc或访问info.php（内容为<?php phpinfo(); ?>）搜索 “APCu Support” - Windows 下用 phpEnv，要进控制面板确认当前运行的 PHP 版本（比如
php-8.5.5），再打开对应路径的C:\phpenv\versions\php-8.5.5\php.ini，检查extension=php_apcu.dll是否写全名、没被分号注释 - Linux/macOS 常见错是装了
pecl install apcu，但忘了加extension=apcu.so到正确的php.ini（FPM 和 CLI 的配置文件通常不同） - 装完必须重启 PHP 进程：Apache 要
sudo systemctl restart apache2，PHP-FPM 是sudo systemctl restart php8.5-fpm，phpEnv 则要点「Stop All」再「Start All」——只刷新浏览器没用
CLI 和 Web 模式必须分别启用
APCu 在 CLI 和 Web（FPM/FastCGI）下是两套独立内存空间，apc.enable_cli=1 不开，composer dump-autoload -o --apcu 就不会写缓存；apc.enabled=1 不开，Web 请求里 apcu_fetch() 直接返回 false。
- 在
php.ini中明确设这两项：apc.enabled=1 apc.enable_cli=1
- Docker 用户注意：
php -i | grep apc查到的值，必须和容器内实际运行 Web 服务时的值一致；常见问题是 Dockerfile 里只改了 CLI 的php.ini，FPM 的配置没同步 - PHP 8.5.5 对扩展兼容性良好，但若同时启用了
opcache.file_cache，APCu 缓存可能被绕过——生产环境建议关掉opcache.file_cache，专注用opcache.memory_consumption+ APCu 分工协作
Composer 自动加载加速必须满足三个条件
composer dump-autoload -o --apcu 不是万能开关，缺一不可。少一个，vendor/composer/autoload_static.php 就不会插入 apcu_fetch() 调用。
立即学习“PHP免费学习笔记（深入）”；
- 项目已执行过
composer dump-autoload -o（即生成 classmap） - PHP 配置中
apc.enabled=1且apc.enable_cli=1 - 命令行明确带
--apcu参数：composer dump-autoload -o --apcu - 执行后立刻检查
vendor/composer/autoload_static.php，搜索apcu_fetch—— 没出现说明根本没生效，不是缓存没命中，是压根没生成 - 缓存 key 带安装路径哈希，换目录、改
composer.json、重装依赖都会让旧缓存自动失效，但不会报错，容易误判“没起作用”
apcu_store() 写入失败的常见原因
调用返回 false 却没报错？大概率是内存不够或单值超限，不是函数不存在。
-
apc.shm_size默认只有 32M，PHP 8.5.5 下建议设为64M或128M；用apcu_sma_info()查剩余内存和碎片情况 -
apc.max_file_size默认 1MB，存大数组（比如含 Base64 图片的配置）会静默失败；先json_encode()压缩，或改用apcu_add()避免覆盖竞态 - APCu 是进程级缓存，不跨 PHP-FPM worker，也不持久化；别指望它替代 Redis 做分布式共享缓存
- 没设
apc.ttl也没关系，默认永不过期，但内存满时会按 LRU 淘汰——所以监控apcu_cache_info()['num_hits'] / ($num_hits + $num_misses)才知道真实命中率
APCu 不是“开了就快”，它是把类映射表或小段数据塞进共享内存，省掉重复解析或磁盘读取。最易忽略的是：CLI 和 Web 的配置要分开验、--apcu 必须和 -o 同时用、缓存失效不报错只悄悄跳过。这些点卡住，再多优化也白搭。
