怎样为PHP 8.5.5启用APCu缓存【加速】-php教程-PHP中文网

apcu在php 8.5.5中需手动安装并正确配置才能生效；常见失败原因包括未启用extension、cli与fpm配置不一致、未重启对应进程、apc.enabled/apc.enable_cli未设为1，以及内存限制过小导致apcu_store静默失败。

怎样为php 8.5.5启用apcu缓存【加速】

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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 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() 调用。

项目已执行过 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) 才知道真实命中率