安装PHPRedis扩展需让PHP能调用Redis服务，推荐使用PECL安装（sudo pecl install redis），需先安装php-dev和编译工具，再在php.ini中添加extension=redis.so并重启PHP服务；也可手动编译（git clone后phpize && make && sudo make install）或用系统包管理器（如apt install php-redis）；常见问题包括缺少开发包、版本不兼容、配置文件错误或未重启服务；验证可通过php -m、phpinfo()或代码连接测试；基础配置可设置会话锁、序列化方式及默认连接参数。
安装PHPRedis扩展，核心就是让你的PHP环境能“认识”并调用Redis的服务。这通常通过编译扩展模块，然后将其加载到PHP的运行时中来实现。具体方法有PECL安装、手动编译，或者直接使用系统包管理器，选择哪种取决于你的系统环境和对版本、灵活性的需求。
解决方案
要让PHP和Redis“搭上线”，通常我会推荐优先考虑PECL，因为它在方便性和版本控制上做得不错。当然，也有其他方法，每种都有它的适用场景。
方法一：使用PECL进行安装（推荐，灵活且相对简单）
这是我个人最常用的方式，尤其当你需要特定版本的PHPRedis时。
立即学习“PHP免费学习笔记（深入）”；
准备工作：在开始之前，确保你的系统已经安装了PHP的开发工具包。这玩意儿是编译PHP扩展的基石。
Debian/Ubuntu:
sudo apt update && sudo apt install php-dev build-essential
CentOS/RHEL:
sudo yum install php-devel gcc make autoconf
安装PHPRedis扩展：有了开发包，就可以用PECL命令来安装了。
sudo pecl install redis
在安装过程中，它可能会问你一些问题，比如要安装哪个版本的PHPRedis。如果你不确定，直接回车选择默认的稳定版通常没错。如果你需要一个特定的版本，比如兼容旧PHP的，你可以这样指定：
sudo pecl install redis-x.y.z
(将
x.y.z
替换为具体版本号)。
配置PHP加载扩展：安装完成后，PECL会告诉你
redis.so
文件被放在了哪里。你需要编辑你的
php.ini
文件，告诉PHP去加载这个扩展。找到你的
php.ini
文件。通常PHP会有好几个
php.ini
，一个用于CLI（命令行），一个用于FPM（Web服务），可能还有一个用于Apache或Nginx的模块。你需要根据你的PHP使用场景来决定修改哪个。
你可以用
php --ini
来查看CLI模式下加载了哪些
php.ini
。对于FPM，通常在
/etc/php/X.Y/fpm/php.ini
(X.Y是PHP版本) 或者
php-fpm.d/www.conf
里面可能会有
php_admin_value
来覆盖。在对应的
php.ini
文件中，添加一行：
extension=redis.so
保存文件。
重启PHP服务：为了让PHP加载新的配置，你必须重启PHP-FPM服务（如果你用Nginx/Apache配合PHP-FPM）或者你的Web服务器（如果你用Apache的mod_php）。
Debian/Ubuntu:
sudo systemctl restart phpX.Y-fpm
(X.Y是你的PHP版本，例如
php7.4-fpm
)CentOS/RHEL:
sudo systemctl restart php-fpm
或者
sudo systemctl restart httpd
(如果Apache)
方法二：手动编译安装（当PECL遇到问题或需要最新开发版时）
有时候PECL可能会抽风，或者你需要GitHub上最新的开发版本。这时候手动编译就派上用场了。
下载源码：访问PHPRedis的GitHub仓库（
https://github.com/phpredis/phpredis
），下载你需要的版本源码包，或者直接
git clone
。
git clone https://github.com/phpredis/phpredis.git
cd phpredis
如果你需要特定版本，可以
git checkout
到对应的tag或分支。
编译安装：
phpize
(这个命令会准备编译环境，确保你安装了
php-dev
或
php-devel
)
./configure
make
sudo make install
配置PHP加载扩展并重启服务：这部分和PECL安装后的步骤一样，编辑
php.ini
添加
extension=redis.so
，然后重启PHP服务。
方法三：使用系统包管理器安装（最省心，但版本可能不是最新）
这是最简单粗暴的方法，尤其适合那些对版本要求不那么高，追求稳定的生产环境。
Debian/Ubuntu:
sudo apt update
sudo apt install php-redis
（这个命令会自动处理依赖和
php.ini
的配置，通常你只需要重启PHP-FPM服务。）CentOS/RHEL:
sudo yum install epel-release
(如果还没安装EPEL仓库)
sudo yum install php-pecl-redis
或者
sudo yum install php-redis
(具体包名可能因版本而异)（同样，它会处理大部分事情，安装后重启PHP服务即可。）
安装PHPRedis扩展时常见的错误有哪些，以及如何排查？
在安装PHPRedis的过程中，我遇到过不少坑，有些是新手常犯的，有些则是环境配置导致的。提前了解这些，能帮你少走弯路。
首先，“phpize command not found” 或者编译过程中出现
configure: error: Cannot find php-config. Please check your PHP installation.
这类错误，几乎百分之九十是因为你没安装PHP的开发头文件。PHP编译扩展需要这些头文件来知道如何与PHP核心交互。解决方法就是安装
php-dev
(Ubuntu/Debian) 或
php-devel
(CentOS/RHEL)。别小看这个，很多人就是卡在这里。
其次，“make”或“make install”时出现大量编译错误，比如
undefined reference to 'zend_hash_str_update'
之类的。这通常意味着你的编译环境有问题，或者你尝试编译的PHPRedis版本与你的PHP版本不兼容。
检查你的
gcc
、
make
等编译工具是否完整安装。在Ubuntu上是
build-essential
包，在CentOS上是
Development Tools
组。更常见的是版本不兼容。比如，你可能在PHP 7.0上尝试编译一个只支持PHP 8.0+的PHPRedis版本。这时候，你需要去PHPRedis的GitHub仓库看看，哪个分支或哪个tag的版本是兼容你的PHP版本的。使用
pecl search redis
也能帮你找到兼容的稳定版。
再者，扩展安装了，但
phpinfo()
里看不到，或者
php -m | grep redis
没输出。这通常是
php.ini
配置问题。
你可能修改了错误的
php.ini
文件。记住，CLI、FPM、Apache模块可能各自加载不同的
php.ini
。最保险的方法是，用
php --ini
查看CLI的，用
phpinfo()
页面查看Web服务的。
extension=redis.so
这行可能写错了，或者写在了
[PHP]
标签之外。扩展文件路径不对。
extension_dir
在
php.ini
里指定了PHP去哪里找扩展。确保
redis.so
文件确实在那个目录下，或者你给出了完整的绝对路径。最重要的，你可能忘记重启PHP-FPM或Web服务器。PHP服务不重启，新的配置就不会生效。
最后，权限问题。在执行
make install
时，如果你没有足够的权限，可能会导致文件无法写入到PHP的扩展目录。这时候，
sudo make install
是你的好朋友。但也要注意，过度使用
sudo
也可能带来其他风险，所以尽量确保你是在正确的目录下执行命令。
PHPRedis扩展安装后如何验证是否成功，并进行基础配置？
PHPRedis扩展安装完毕后，验证工作是必不可少的，这能确保你的努力没有白费。同时，一些基础配置能让它更好地工作。
验证PHPRedis是否成功加载：
命令行验证：最快的方式是在命令行里检查。
php -m | grep redis
如果输出中包含
redis
，那就说明CLI模式下的PHP已经成功加载了PHPRedis扩展。
Web服务器验证（
phpinfo()
）：如果你主要在Web环境中使用PHP，那么通过
phpinfo()
页面来验证更为直接。创建一个
info.php
文件，内容如下：
将这个文件放到你的Web服务器根目录，通过浏览器访问它。在打开的页面中搜索“redis”。如果找到了一个“redis”的配置段，并且里面列出了各种Redis相关的配置项，那么恭喜你，Web环境下的PHPRedis也加载成功了。
简单代码测试：这是最直观的验证方式，直接用PHP代码尝试连接Redis。
connect('127.0.0.1', 6379); // 替换为你的Redis服务器地址和端口 $redis->set('test_key', 'Hello Redis from PHP!'); echo $redis->get('test_key'); $redis->close(); echo "nPHPRedis扩展工作正常，并成功连接到Redis！n";} catch (RedisException $e) { echo "PHPRedis连接失败或扩展未加载： " . $e->getMessage() . "n";}?>
运行这段代码，如果能看到
Hello Redis from PHP!
并提示“PHPRedis扩展工作正常”，那就说明一切OK了。
PHPRedis基础配置：
PHPRedis扩展提供了一些
php.ini
配置项，可以优化其行为，或者设置一些默认值。这些配置通常放在
php.ini
文件中
extension=redis.so
之后，或者在一个单独的配置文件中（如
redis.ini
）。
redis.session.locking_enabled = 1
： 如果你打算用Redis来存储PHP会话（session），并且希望防止会话并发写入导致的数据损坏，开启这个锁是很有必要的。它会在会话写入时加锁。
redis.session.lock_retries = -1
： 当会话锁失败时，重试的次数。
-1
表示无限重试，直到成功。
redis.session.lock_wait_time = 10000
： 每次重试等待的时间，单位是微秒。
redis.session.serializer = igbinary
： 如果你安装了
igbinary
扩展，并且希望用它来序列化会话数据，可以设置为
igbinary
。它通常比PHP自带的
php
序列化器更快，并且生成的体积更小。
redis.session.prefix = "PHPREDIS_SESSION:"
： 为Redis中存储的会话键添加一个前缀，方便管理和区分。
redis.default_host = "127.0.0.1"
和
redis.default_port = 6379
： 这些是PHPRedis默认连接的Redis服务器地址和端口。如果你在代码中没有显式指定连接参数，它会尝试使用这些默认值。不过，我个人更倾向于在代码中明确指定连接信息，这样更灵活。
配置完这些，别忘了再次重启你的PHP服务，让新的配置生效。
为什么选择PECL安装PHPRedis，与手动编译或包管理器安装有何不同？
在安装PHPRedis扩展时，我们有PECL、手动编译和包管理器这三种主要方式。每种方式都有其独特的优缺点和适用场景，理解这些差异能帮助你做出更明智的选择。
1. PECL 安装（PHP Extension Community Library）
优点：官方推荐： PECL是PHP官方维护的扩展仓库，通常能获取到最新且稳定的PHPRedis版本。版本管理方便： 你可以通过
pecl install redis-x.y.z
来安装特定版本的扩展，这对于兼容性要求高的项目非常有用。依赖处理相对智能： PECL在安装时会尝试解决一些依赖问题，虽然不是万能，但比手动处理要省心。升级相对简单：
pecl upgrade redis
可以相对方便地升级扩展。缺点：仍需编译环境： 尽管PECL简化了过程，但它本质上还是下载源码进行编译，所以你仍然需要
php-dev
、
gcc
等编译工具。有时会遇到依赖冲突： 偶尔，PECL在处理复杂的系统依赖时可能会卡壳，需要你手动介入。对新手仍有门槛： 相比包管理器，PECL安装还是需要一些命令行操作和对PHP环境的理解。适用场景：当你需要安装最新稳定版的PHPRedis时。当你需要安装特定版本的PHPRedis以满足项目兼容性需求时。在开发环境或对版本有一定要求的生产环境。
2. 手动编译安装
优点：极致的灵活性： 你可以直接从GitHub获取任何分支、任何提交的PHPRedis源码进行编译。这对于测试最新功能、贡献代码或者解决非常特定的兼容性问题至关重要。完全掌控： 从下载到编译到安装，所有步骤都在你的控制之下，可以进行各种定制。缺点：过程最复杂： 需要手动处理所有依赖、配置和编译参数，对操作者的技术要求最高，容易出错。耗时且易错： 任何一个环节的疏忽都可能导致编译失败。维护成本高： 升级或卸载都需要手动操作，没有自动化工具的便利。适用场景：PHPRedis的开发者或贡献者。需要测试PHPRedis的最新开发功能或未发布版本。PECL或包管理器都无法满足特定需求（如非常旧的PHP版本或非常新的PHPRedis功能）。解决极其特殊的编译或兼容性问题。
3. 包管理器安装（如
apt
或
yum
）
优点：最简单省心： 通常只需一条命令即可完成安装，包管理器会自动处理所有依赖，并配置好
php.ini
。高度兼容： 包管理器提供的PHPRedis版本通常是经过发行版测试的，与系统PHP版本兼容性最好，稳定性高。维护方便： 升级和卸载也通过包管理器进行，非常便捷。缺点：版本滞后： 包管理器中的PHPRedis版本通常不是最新的，可能落后于PHPRedis的最新功能和性能优化。灵活性差： 无法轻易安装特定版本的PHPRedis，通常只能安装仓库中提供的版本。无法满足特定需求： 如果你的项目依赖PHPRedis的某个新功能，而包管理器中的版本不支持，那就无能为力了。适用场景：追求稳定性和简便性的生产环境。对PHPRedis版本要求不高，或者只需要基本功能的项目。新手用户，希望快速搭建环境。
总结一下：
我通常会先尝试PECL安装，因为它在便捷性和版本选择之间找到了一个很好的平衡点。如果PECL不给力，或者我需要一些前沿特性，才会考虑手动编译。而对于那些追求“一次安装，长期稳定”的生产环境，如果包管理器提供的版本足够用，那它无疑是最省心的选择。选择哪种方式，最终还是取决于你的具体需求、技术栈和对风险的承受能力。
以上就是PHP怎么安装Redis扩展_PHPRedis扩展安装方法的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1320552.html
微信扫一扫 
支付宝扫一扫 
