CentOS 下给 PHP 安装 Redis 扩展

云舒
云舒
发布时间:2026-08-25 | 184人浏览过
原创

前言

在 CentOS 上给 PHP 补装 Redis 扩展,真正容易卡住的通常不是命令本身,而是编译路径、配置文件和生效验证这几步。本文按源码安装顺序整理关键操作,帮你快速判断该改哪里、装到了没有。

Redis 常被用作缓存、数据库或消息中间件,而在 PHP 项目里,要真正调用它,关键是先把 redis 扩展装进运行环境。下面按 CentOS 下最常见的源码安装流程梳理一遍,从下载、编译到配置和验证,方便你快速定位每一步该看什么、改什么。

下载并编译 Redis 扩展

这篇只讨论 PHP 环境里的 redis 扩展安装,不展开 Redis 服务本身的安装与配置。不同环境下安装扩展的方法不一样,这里采用源码方式,适合已经有独立 PHP 安装目录的服务器。

用纸面步骤卡片展示 PHP Redis 扩展从下载到编译安装的顺序
源码安装流程图从源码包到 make install,关键是 phpize 与 php-config 两个节点。

先下载指定版本的扩展源码包:

wget http://pecl.php.net/get/redis-5.2.0.tgz

下载完成后解压:

tar -xzf redis-5.2.0.tgz 

进入源码目录,准备编译:

cd redis-5.2.0

接下来先执行 phpize。这个命令通常位于 PHP 安装目录下的 bin 目录中,如果你是源码安装 PHP,往往需要写出完整路径:

/usr/local/php/bin/phpize

phpize 的作用是为当前扩展生成适合本机 PHP 环境的编译配置,这是很多人安装扩展时最容易漏掉的一步。

然后执行 configure,这里要明确指定 php-config 的位置。它同样通常位于 PHP 安装目录的 bin 下:

./configure --with-php-config=/usr/local/php/bin/php-config

确认无报错后,再进行正式编译和安装:

make && make install

执行完成后,系统会把编译好的 redis.so 安装到 PHP 扩展目录,接下来就差把它写进配置文件并重启服务。

在 php.ini 中启用扩展

编译安装完成,不代表 PHP 已经自动加载该模块。你还需要找到 php.ini 配置文件,一般在 PHP 安装目录下的 etc 目录里,然后在文件末尾加入以下内容:

[redis]
extension="redis.so"

这里的核心是让 PHP 在启动时加载 redis.so。如果你的环境里有多个 php.ini,例如命令行和 php-fpm 使用的配置不同,就需要确认修改的是实际生效的那一份。

重启服务并检查是否生效

配置写入后,还要重启相关服务,常见场景就是重启 php-fpm,这样扩展配置才会真正生效。

用配置卡片和检查清单展示 php.ini 启用 Redis 扩展与生效验证
启用与验证要点真正生效取决于 php.ini 是否正确加载,以及服务是否已经重启。

验证方式有两种。第一种是在页面里查看 phpinfo(),如果能看到 redis 模块,说明扩展已经成功加载。

第二种是在命令行直接检查已安装模块列表:

php -m

如果输出结果中包含 redis,通常就说明 PHP 扩展已经安装完成。到这一步,CentOS 下通过源码给 PHP 安装 Redis 扩展的流程就走通了。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表