phpEnv 中安装 APCu 必须用 phpenv ext install apcu 8.2（主次版本号），而非 pecl install；配置需写入 ~/.phpenv/versions/x.x.x/etc/conf.d/ext-apcu.ini，并设 apc.shm_size=64M、apc.enable_cli=0，重启 php-fpm 后用 apcu_cache_info() 验证。
phpEnv 下 APCu 无法直接通过 pecl install apcu 安装——它不走系统级 PECL，而是依赖 phpEnv 自带的扩展管理机制。必须用 phpEnv 提供的 phpenv ext install 命令，且需确认 PHP 版本与扩展兼容性。
phpEnv 中启用 APCu 的正确安装路径
phpEnv 是基于多版本 PHP 切换的环境管理工具，其扩展安装逻辑与系统全局 PHP 不同。直接运行 pecl install apcu 会失败或装到错误的 PHP 实例中。
- 先确认当前使用的 PHP 版本：
phpenv version（例如输出8.2.15） - 执行专用安装命令：
phpenv ext install apcu 8.2（注意：版本号只需主次号，如8.2，不是完整8.2.15） - 安装成功后，扩展文件（
apcu.so）会自动放入该版本 PHP 的ext目录，并生成对应 ini 配置 - 无需手动编辑
php.ini，phpEnv 会在~/.phpenv/versions/8.2.15/etc/conf.d/ext-apcu.ini中写入：extension=apcu.soapc.enabled=1
为什么 apc.shm_size 要在 phpEnv 的 per-version ini 里配
phpEnv 每个 PHP 版本有独立配置目录，全局 /etc/php.ini 对它无效。若你在系统 php.ini 里设了 apc.shm_size=64M，切换到 phpEnv 管理的版本时完全不生效。
- 正确位置是：
~/.phpenv/versions/8.2.15/etc/conf.d/ext-apcu.ini - 追加配置项即可：
apc.shm_size=128M（建议从 64M 起步，根据缓存对象大小调整） -
apc.ttl=3600推荐显式设置，避免默认 0（永不过期）导致 stale 数据堆积 - 务必禁用 CLI 模式：
apc.enable_cli=0，否则单元测试或 Artisan 命令会意外占用共享内存
验证 APCu 是否真在运行，而不是“看起来启了”
常见假阳性：phpinfo() 页面显示 APCu 模块已加载，但 apcu_fetch() 始终返回 false——多半是权限或共享内存冲突。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -r "var_dump(apcu_cache_info());"，若报APCu is not enabled或空数组，说明未真正启用 - 检查错误日志：
tail -f ~/.phpenv/versions/8.2.15/var/log/php-fpm.log，留意Failed to initialize APCu shared memory - Linux 下若提示
shmget() failed，大概率是内核参数限制：cat /proc/sys/kernel/shmall和shmax过小，需调高 - 最简验证代码：
apcu_store('test', 'ok'); var_dump(apcu_fetch('test'));，输出string(2) "ok"才算通
APCu 和 OPcache 共存时最容易忽略的冲突点
两者都依赖共享内存，但 phpEnv 下 OPcache 默认由 PHP 编译时内置，而 APCu 是后装扩展——它们的共享内存段可能被内核分配到同一区域，引发静默失败。
- OPcache 的
opcache.memory_consumption和 APCu 的apc.shm_size总和不能超过系统shmall限制 - 不要设
apc.shm_size=256M+opcache.memory_consumption=256M→ 极易触发Cannot allocate shared memory - 推荐组合：
opcache.memory_consumption=128M+apc.shm_size=64M（中小项目够用） - 重启生效方式：必须重启 php-fpm（或 Apache/Nginx），仅
phpenv rehash不起作用
APCu 在 phpEnv 中不是“装上就跑”，它的共享内存段由内核按需分配，一旦失败不会报错到 Web 层，只默默退化为无缓存状态。上线前务必用 apcu_cache_info() 和真实数据读写双重验证。
