ubuntu 22.04 可直接 apt 安装 php8.1-redis 扩展,需确认 php 8.1 nts 模式及对应服务(fpm/apache),安装后重启服务并验证 redis 模块加载成功。

直接用 apt 安装即可,Ubuntu 22.04 官方源已内置适配 PHP 8.1 的 redis 扩展包,无需编译,关键是要匹配版本号和运行模式。
确认当前 PHP 8.1 环境
先检查你实际在用的 PHP 版本及构建信息:
- 运行 php -v 确认输出含 8.1.x(如 8.1.27)
- 运行 php -i | grep -E "(Thread Safety|Server API)" 确认:
• Thread Safety 显示 disabled(即 NTS 模式,Ubuntu 默认)
• Server API 是 FPM 或 Apache2Handler(非 CLI 场景也需对应服务)
安装 php8.1-redis 包
Ubuntu 22.04 的 apt 源中,扩展包命名严格绑定主版本。执行:
- sudo apt update
- sudo apt install php8.1-redis
该命令会自动安装适配 PHP 8.1、NTS、production 模式的 redis.so,并写入配置文件 /etc/php/8.1/mods-available/redis.ini。
启用扩展并重启服务
安装后扩展默认已启用,但需重启对应 PHP 进程才能生效:
- 如果你用的是 PHP-FPM(Nginx 常见):
sudo systemctl restart php8.1-fpm - 如果你用的是 Apache:
sudo systemctl restart apache2 - 验证是否加载成功:
php -m | grep redis → 应输出redis
或运行 php -r "new Redis(); echo 'OK';" → 不报错即为可用
注意多 PHP 版本共存情况
若系统同时装了 PHP 8.1 和 8.2:
- 务必使用 php8.1-redis,而非
php-redis(后者可能装到默认 PHP,通常是低版本) - 检查 php --ini 输出的配置路径,确认启用的是
/etc/php/8.1/cli/php.ini或/etc/php/8.1/fpm/php.ini中的 redis.ini
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











