位置:首页 > 综合教程 > Linux系统安装PHP Redis扩展教程

Linux系统安装PHP Redis扩展教程

时间:2026-08-03  |  作者:电竞小硕  |  阅读:0

在Linux环境下给PHP装上Redis扩展,步骤看似不少,但理清了也就几条命令的事。不少人在编译安装阶段容易卡壳——要么路径没对,要么php.ini配置漏了细节。今天咱们就把整个过程拆开揉碎,一步步说清楚。

本文以Redis 4.0版本扩展为例。具体版本号可根据实际需要调整,但流程基本通用。

第一步:下载并解压Redis扩展包

先去PECL官网(pecl.php.net/package/redis),找到对应你PHP版本的Redis扩展包,下载下来。

用Putty或WinSCP这类工具,把压缩包传到Linux服务器上。然后解压、进入源码目录——准备工作就算齐活了。

前提是你的PHP运行环境已经搭好,不然编译工具都用不了。

第二步:执行phpize生成configure脚本

切换到扩展源码所在的目录,执行PHP自带的构建工具命令:

/你的PHP安装路径/bin/phpize

常见路径是/usr/local/php/bin/phpize。这步的作用是生成后续编译所需的configure脚本。跑完你就知道有没有缺什么依赖。

Linux系统安装PHP Redis扩展教程_wishdown.com

第三步:运行configure配置

phpize执行成功后,运行配置命令:

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

注意:--with-php-config后面的路径一定要对,得是你实际PHP安装目录下的php-config文件位置。路径写错了,编译环境初始化就会翻车。

Linux系统安装PHP Redis扩展教程_wishdown.com

第四步:记录编译后.so文件路径

编译安装完成后,注意记下Redis扩展生成的.so文件路径。默认会放在modules/redis.so,但也有可能跑到别处。

这个路径后面配置php.ini时要用到,马虎不得。有些安装脚本可能会自动帮你写进php.ini。但为了防一手冲突,建议手动确认并把路径记下来,顺便备份一下原配置文件。

Linux系统安装PHP Redis扩展教程_wishdown.com

第五步:编辑php.ini添加扩展配置

编辑PHP的主配置文件php.ini。在文件末尾加上这样一行:

extension=/path/to/redis.so

(把/path/to/换成你刚才记下来的实际路径。)

注意检查路径有没有写对、有没有多余的空格或分号,语法格式一点都不能错。图中的示例就是正确写法。如果配错了,扩展加载会直接报错,测都测不了。

Linux系统安装PHP Redis扩展教程_wishdown.com

Linux系统安装PHP Redis扩展教程_wishdown.com

第六步:重启PHP和Web服务器

配置写完后,必须重启PHP和Web服务器才能让改动生效。

  • 先重启PHP-FPM服务:运行/etc/init.d/php-fpm restartsystemctl restart php-fpm,具体看你系统用的是哪种服务管理方式。
  • 接着重载Nginx配置:执行nginx -s reload,实现平滑重载,不用停服。

Linux系统安装PHP Redis扩展教程_wishdown.com

第七步:验证安装结果

新建一个测试页,比如info.php,里面写上。然后在浏览器里访问这个页面。

在页面中搜索“redis”。如果能看到相关的模块信息、版本号之类的,说明扩展已经成功加载,大功告成。

Linux系统安装PHP Redis扩展教程_wishdown.com

免责声明:文中图文均来自网络,如有侵权请联系删除,心愿游戏发布此文仅为传递信息,不代表心愿游戏认同其观点或证实其描述。

相关文章

更多

精选合集

更多

大家都在玩

热门话题

大家都在看

更多