PHP安装Redis扩展详细教程

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《PHP安装Redis扩展方法详解》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

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

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.gitcd 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 updatesudo 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是否成功加载：

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环境搭建的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP安装Redis扩展详细教程》文章吧，也可关注golang学习网公众号了解相关技术文章。