首先安装 APCu 扩展,可通过 apt 或 PECL 方式;然后配置php.ini 启用扩展并设置参数;最后重启服务并验证缓存功能是否正常。

如果您在配置 PHP 环境时希望提升用户数据缓存性能,可以启用 APCu(Alternative PHP Cache – user cache)扩展来实现高效内存级数据存储。以下是完成 APCu 安装与配置的具体步骤。
本文运行环境:Dell XPS 13,ubuntu 22.04
一、通过包管理器安装 APCu 扩展
使用系统自带的包管理 工具 可以快速安装已编译好的 APCu 扩展,适用于大多数标准 PHP 环境。
1、打开终端并更新软件包列表:sudo apt update。
立即学习“PHP 免费学习笔记(深入)”;
2、根据当前 PHP 版本安装对应的 APCu 扩展,例如 PHP 8.1 环境下执行:sudo apt install php8.1-apcu。
3、安装完成后重启 Web 服务器服务,如 apache 执行:sudo systemctl restart apache2。
二、使用 PECL 手动安装 APCu
当系统仓库中没有合适版本或需要最新功能时,可通过 PECL(PHP Extension Community Library)源码安装 APCu。
1、确保已安装 php-pear 和开发依赖包:sudo apt install php-dev php-pear。
2、执行 PECL 命令安装 APCu:sudo pecl install apcu。
3、安装过程中若提示是否启用全页缓存(System-wide APC),选择“no”仅启用用户缓存功能。
4、安装成功后,需手动在 php.ini 文件中添加扩展加载指令:extension=apcu.so。
三、配置 APCu 参数以优化缓存行为
调整 php.ini 中的 APCu 配置项可控制内存分配、过期策略等核心行为,满足不同应用需求。
1、找到当前生效的 php.ini 文件路径,通常位于/etc/php/ 版本号 /apache2/php.ini 或 CLI 模式下使用 php –ini 查看。
2、编辑 php.ini 文件,在末尾添加或修改以下关键参数:
apc.enabled=1
apc.shm_size=128M
apc.ttl=7200
apc.enable_cli=1
3、保存更改并重启 Web 服务器使配置生效。
四、验证 APCu 是否正常工作
通过创建测试脚本检查 APCu 扩展是否成功加载并能执行基本缓存操作。
1、新建一个 PHP 文件如 info.php,写入代码:<?php phpinfo(); ?>。
2、在 浏览器 访问该文件,搜索“APCu”确认模块信息已显示。
3、编写简单缓存测试脚本:
<?php
$key = ‘test_key’;
apcu_store($key, ‘Hello APCu’, 600);
?>
若输出“Hello APCu”,则表明缓存读写功能正常。


