安装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免费学习笔记（深入）”；

1. 准备工作： 在开始之前，确保你的系统已经安装了PHP的开发工具包。这玩意儿是编译PHP扩展的基石。

   • Debian/Ubuntu:

     sudo apt update && sudo apt install php-dev build-essential
   • CentOS/RHEL:

     sudo yum install php-devel gcc make autoconf

2. 安装PHPRedis扩展： 有了开发包，就可以用PECL命令来安装了。

   sudo pecl install redis

   在安装过程中，它可能会问你一些问题，比如要安装哪个版本的PHPRedis。如果你不确定，直接回车选择默认的稳定版通常没错。如果你需要一个特定的版本，比如兼容旧PHP的，你可以这样指定：

   sudo pecl install redis-x.y.z

   (将

   x.y.z

   替换为具体版本号)。

3. 配置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

     保存文件。

4. 重启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上最新的开发版本。这时候手动编译就派上用场了。

1. 下载源码： 访问PHPRedis的GitHub仓库（

   https://github.com/phpredis/phpredis

   ），下载你需要的版本源码包，或者直接

   git clone

   。

   git clone https://github.com/phpredis/phpredis.git

   cd phpredis

   如果你需要特定版本，可以

   git checkout

   到对应的tag或分支。

2. 编译安装：

   • phpize

     (这个命令会准备编译环境，确保你安装了

     php-dev

     或

     php-devel

     )

   • ./configure

   • make

   • sudo make install

3. 配置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

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

Vimi

Vimi是商汤科技发布的全球首个可控人物的ai视频生成大模型

153

查看详情

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

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

验证PHPRedis是否成功加载：

1. 命令行验证： 最快的方式是在命令行里检查。

   php -m | grep redis

   如果输出中包含

   redis

   ，那就说明CLI模式下的PHP已经成功加载了PHPRedis扩展。

2. Web服务器验证（

   phpinfo()

   ）： 如果你主要在Web环境中使用PHP，那么通过

   phpinfo()

   页面来验证更为直接。 创建一个

   info.php

   文件，内容如下：

   <?php phpinfo(); ?>

   将这个文件放到你的Web服务器根目录，通过浏览器访问它。在打开的页面中搜索“redis”。如果找到了一个“redis”的配置段，并且里面列出了各种Redis相关的配置项，那么恭喜你，Web环境下的PHPRedis也加载成功了。

3. 简单代码测试： 这是最直观的验证方式，直接用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环境搭建 php redis centos git php7 apache github nginx 浏览器 端口 php nginx Session Error 栈 并发 undefined github git redis apache https ubuntu centos 性能优化 debian 自动化