PHP怎么安装Redis扩展_PHPRedis扩展安装方法-php教程-PHP中文网

安装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()或代码连接测试；基础配置可设置会话锁、序列化方式及默认连接参数。

php怎么安装redis扩展_phpredis扩展安装方法

安装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

登录后复制

也可能带来其他风险，所以尽量确保你是在正确的目录下执行命令。

乐活途购物分享社区

beta v1.1版本为第一个版本，简单的整合了基础功能，各位站长拿到程序后，不要纠结后台的功能简单，后续将不断更新扩展。在beta v1.1版本使用过程中遇到什么问题，请登录 www.loftto.com 进行反馈！安装说明######重要提醒：程序不支持二级目录安装，请使用一级目录或二级目录绑定！#第一步，确定你的服务器支持PHP+mysql。#第二步，确定你的服务器开启了gd库。#第三步，

查看详情

PHPRedis扩展安装后如何验证是否成功，并进行基础配置？

PHPRedis扩展安装完毕后，验证工作是必不可少的，这能确保你的努力没有白费。同时，一些基础配置能让它更好地工作。

验证PHPRedis是否成功加载：

命令行验证： 最快的方式是在命令行里检查。
```
php -m | grep redis
```
登录后复制
如果输出中包含
```
redis
```
登录后复制
，那就说明CLI模式下的PHP已经成功加载了PHPRedis扩展。
Web服务器验证（
```
phpinfo()
```
登录后复制
）：如果你主要在Web环境中使用PHP，那么通过
```
phpinfo()
```
登录后复制
页面来验证更为直接。创建一个
```
info.php
```
登录后复制
文件，内容如下：
```
<?php
phpinfo();
?>
```
登录后复制
将这个文件放到你的Web服务器根目录，通过浏览器访问它。在打开的页面中搜索“redis”。如果找到了一个“redis”的配置段，并且里面列出了各种Redis相关的配置项，那么恭喜你，Web环境下的PHPRedis也加载成功了。

简单代码测试： 这是最直观的验证方式，直接用PHP代码尝试连接Redis。

<?php
try {
    $redis = new Redis();
    $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中文网其它相关文章！