php 8.4.1 安装 redis 扩展需三步:确认 php 环境与开发依赖(phpize、gcc 等),下载编译 phpredis 6.0.3+ 源码并 make install,最后在 php.ini 中配置 extension=redis.so 并重启服务验证。

PHP 8.4.1 安装 Redis 扩展在 Linux 上不难,关键是编译环境、扩展源码匹配和配置加载三步到位。官方 redis 扩展已支持 PHP 8.4(截至 2026 年,最新稳定版为 phpredis 6.0.3+),无需降级或打补丁。
确认 PHP 环境与开发依赖
先确保 PHP 8.4.1 已正确安装并可调用:
- 运行
php -v输出应含PHP 8.4.1,且路径为编译安装的/usr/local/php/bin/php或包管理安装的对应路径 - 检查是否已安装
phpize:执行which phpize,若无,说明未装 PHP 开发头文件 —— 需安装php8.4-dev(Debian/Ubuntu)或php-devel(RHEL/Rocky) - 基础编译工具必须就位:
gcc、make、autoconf;如未安装,Debian 系执行sudo apt install build-essential autoconf,RHEL 系执行sudo dnf groupinstall "Development Tools"
下载并编译安装 phpredis 扩展
推荐使用官方 GitHub 最新版(兼容 PHP 8.4):
- 进入临时目录,下载源码:
wget https://github.com/phpredis/phpredis/archive/refs/tags/6.0.3.tar.gz - 解压并进入:
tar -xzf 6.0.3.tar.gz && cd phpredis-6.0.3 - 用当前 PHP 的
phpize初始化构建环境:/usr/local/php/bin/phpize(路径按你实际 PHP 安装位置调整) - 配置编译参数:
./configure --with-php-config=/usr/local/php/bin/php-config - 编译安装:
make && sudo make install - 成功后会输出类似
Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20230831/,记下该路径
启用扩展并验证
让 PHP 加载 redis.so:
- 编辑
php.ini(可通过php --ini查找主配置文件位置) - 在文件末尾添加一行:
extension=redis.so - 如果扩展不在默认 extension_dir 下,需先指定路径:
extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20230831/" - 保存后重启 PHP-FPM 或 Web 服务(如
sudo systemctl restart php-fpm) - 验证是否生效:
php -m | grep redis应输出redis;或运行php -r "echo extension_loaded('redis') ? 'yes' : 'no';"输出yes
可选:配置序列化方式提升性能(宝塔/生产环境常用)
若同时用了 igbinary(如宝塔中常配),可进一步优化序列化效率:
- 确保已安装
igbinary扩展(需单独编译,步骤同 redis) - 在
php.ini中追加:redis.serializer = igbinary - 重启 PHP 后,在脚本中测试:
var_dump(Redis::SERIALIZER_IGBINARY === (new Redis())->getSerializer());返回true即生效
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











