1. 准备工作与环境要求
在正式安装前，务必确认服务器的基础环境与兼容性，这是确保 Redis 扩展稳定工作的前提。正确理解关键点可以避免重复劳动和后续故障。
系统依赖与构建工具是安装过程的基础，常见的组件包括 php-dev、gcc、make、autoconf 等。缺失这些工具可能导致 pecl 构建失败或源码编译出错。
# 以 Debian/Ubuntu 为例安装常用依赖
sudo apt-get update
sudo apt-get install -y php-dev gcc make autoconf automake
检查 PHP 的加载路径与运行模式，以确保 CLI、FPM/NGINX、以及 Web 服务器在同一系统中都能加载到 Redis 扩展。
php --ini
在多版本或容器化环境中要区分版本目录与运行时，避免在某个 SAPI 下加载了但在另一个 SAPI 中未启用的扩展。
1.1 确认 PHP 版本与兼容性
不同的 PHP 主版本对扩展的兼容性有所差异，确保 Redis 扩展版本与当前 PHP 版本兼容，并留意官方文档中的版本矩阵。
1.2 检查系统依赖与编译工具
若计划手动编译或从源码安装，保持编译工具链完整，以免在后续步骤遇到缺少库或头文件的问题。
1.3 指定运行环境的加载路径
对于不同的运行方式，分别在 CLI 与 FPM/Web 的配置中加载扩展，避免某一环境无法使用 Redis。
2. 安装 Redis 扩展的多种方式
PECL 安装是最常用、最简单的方式，适合服务器直接联网且希望快速集成。
pecl install redis
安装完成后，需要在相应的 PHP 配置中启用扩展，确保在所有运行模式下都生效（CLI、FPM、Apache 等）。
# 以 PHP 7.4 为例，分别为 CLI 与 FPM/WEB 配置添加扩展
sudo bash -lc 'echo "extension=redis.so" > /etc/php/7.4/cli/conf.d/20-redis.ini'
sudo bash -lc 'echo "extension=redis.so" > /etc/php/7.4/fpm/conf.d/20-redis.ini'
完成后，请重启对应的服务以使改动生效，通常需要重启 PHP-FPM、Apache 或 Nginx 的后端进程。
sudo systemctl restart php7.4-fpm
# 或者
sudo systemctl restart apache2
从源码安装适用于需要特定编译参数或自定义构建的场景，过程相对复杂但可控性更高。
2.1 使用 PECL 安装（再次确认）
如果可用，优先选择 PECL 安装并直接通过 php -m 验证扩展是否正确加载。
pecl install redis
php -m | grep redis
2.2 从源码编译安装
在某些受限环境或需要开启特定编译选项时，可以通过源码安装，步骤如下，确保你已安装 phpize、configure、make、gcc等工具。
git clone https://github.com/phpredis/phpredis.git
cd phpredis
phpize
./configure
make
sudo make install
安装完成后，同样需要在 php.ini 中显式加载 extension=redis.so，并重启相关服务。
echo "extension=redis.so" | sudo tee /etc/php/7.4/cli/conf.d/20-redis.ini
2.3 通过系统包管理器安装
部分发行版提供了打包好的 Redis 扩展，使用系统包管理器可以简化升级与依赖管理，适合希望保持系统包一致性的场景。
# Debian/Ubuntu
sudo apt-get install php-redis
sudo systemctl restart php7.4-fpm# RHEL/CentOS（示例，实际包名以仓库为准）
sudo yum install php-pecl-redis
sudo systemctl restart php-fpm
3. 配置与启用 Redis 扩展
启用扩展与基础配置是确保 Redis 能被 PHP 正确调用的关键，下面给出在不同场景中的具体做法。
3.1 修改 php.ini 启用扩展
无论使用哪种安装方式，第一步通常是确保 extension=redis.so 已加载，并覆盖到所有需要的 SAPI。
sudo bash -lc 'echo "extension=redis.so" > /etc/php/7.4/cli/conf.d/20-redis.ini'
sudo bash -lc 'echo "extension=redis.so" > /etc/php/7.4/fpm/conf.d/20-redis.ini'
在 Windows 服务器上，需要将扩展 DLL 名称添加到 php.ini，如 extension=php_redis.dll。
3.2 配置连接参数与认证
通过 PHP 代码来建立连接和认证，是最直接的做法，确保主机、端口、以及认证信息的正确性。
connect('127.0.0.1', 6379);
$redis->auth('your_password'); // 如果 Redis 设置了认证
$redis->select(0); // 选择默认数据库
如果你的应用需要将 Redis 作为会话存储或缓存介质，可以通过配置 session.save_handler 与 session.save_path 实现，示例代码如下。
3.3 会话处理与数据缓存配置
将 Redis 用作会话处理器和缓存时，合理设置数据库分区、TTL、以及持久化策略，以提升应用性能并降低延迟。
以下为简单的读写缓存示例，帮助你快速验证连接与基本操作是否正常。
connect('127.0.0.1', 6379);
$redis->set('site:views', 1234, 3600); // 设置带 TTL 的缓存
echo $redis->get('site:views');
?>
4. 常见问题排查与调试技巧
在生产环境中遇到问题时，系统化排查是提升可用性的关键，下面列出常见场景及对应排查思路。
4.1 连接失败与超时排查
如果出现连接失败或超时，首先检查 Redis 服务是否运行，以及网络连通性与防火墙设置。
systemctl status redis
redis-cli -h 127.0.0.1 -p 6379 ping
redis-cli -a 'your_password' -h 127.0.0.1 -p 6379 ping
确保 PHP 端能到达 Redis，并且认证信息正确，否则会出现授权错误或连接阻塞。
4.2 扩展未加载与版本冲突排查
若出现扩展未加载的错误，先确认 php -m 是否包含 redis，以及 extension_dir 的实际路径。
php -m | grep redis
php -i | grep extension_dir
php --ri redis
如未加载，检查 php.ini 的配置路径、是否在正确的 SAPI 下加载，以及重启相应的服务。
4.3 序列化、数据类型与缓存命中问题
使用 Redis 时，数据的序列化格式与命中率会影响应用行为，避免直接存储复杂对象而未进行序列化处理。
connect('127.0.0.1', 6379);
$payload = json_encode(['a'=>1,'b'=>2]);
$redis->set('payload', $payload);
$raw = $redis->get('payload');
$data = json_decode($raw, true);
4.4 性能与内存参数调优
通过 Redis 客户端与服务端的诊断工具，监控命中率、延迟与内存使用，并结合应用实际负载进行参数调整，例如设置合理的 TTL、避免长时间阻塞操作。
redis-cli INFO
Redis info: keyspace, memory, db0 db0:keys=1000,expires=0,avg_ttl=0
5. 验证与测试方法
在完成安装与配置后，进行实际验证是最直接的确认方法。
5.1 使用 PING 测试连通性
通过 PHP 代码或命令行直接对 Redis 服务发出 PING，验证网络与认证状态。
php -r '$r=new Redis(); $r->connect("127.0.0.1",6379); var_dump($r->ping());'
5.2 在 PHP 中进行读写测试
简单的读写测试可以快速验证扩展是否工作正常，确保能写入和读取数据，并控制好 TTL 以观察过期行为。
connect('127.0.0.1', 6379);
$redis->set('test:key','hello-redis', 3600);
echo $redis->get('test:key');
?>
