phpEnv Nginx配置实现多PHP版本共用Redis实例的方法
phpEnv是一款集成了Nginx、多版本PHP、MySQL等常用开发组件的集成环境,适合需要同时运行不同PHP版本项目的开发者使用。Redis作为常用的缓存和键值存储工具,多个项目共用同一个实例可以有效降低服务器资源消耗,避免重复部署Redis服务。下面详细介绍具体的实现步骤。

一、环境准备与前置条件
首先确保phpEnv已经正常安装,并且已经添加了至少两个不同版本的PHP,比如PHP7.4和PHP8.1。同时需要确认Redis服务已经启动,并且可以正常访问。可以通过以下命令检查Redis服务状态:
# 检查Redis服务运行状态 ps aux | grep redis # 测试Redis连接 redis-cli ping
如果返回PONG说明Redis服务正常运行。接下来需要为两个PHP版本分别安装Redis扩展,不同PHP版本的安装方式略有区别。
二、多PHP版本安装Redis扩展
phpEnv中每个PHP版本是独立存在的,需要分别为每个版本安装对应的Redis扩展。
1. PHP7.4安装Redis扩展
打开phpEnv的PHP管理面板,选择PHP7.4版本,点击扩展管理,找到Redis扩展并安装。如果扩展列表中没有对应版本,可以手动下载对应PHP7.4版本的Redis扩展文件,放到PHP7.4的ext目录下,然后修改php.ini文件添加扩展配置:
extension=redis
修改完成后重启PHP7.4服务,通过phpinfo()查看是否成功加载Redis扩展。
2. PHP8.1安装Redis扩展
同样打开phpEnv的PHP管理面板,选择PHP8.1版本,安装对应的Redis扩展。PHP8.1的Redis扩展版本需要和PHP8.1兼容,手动安装时同样将扩展文件放到PHP8.1的ext目录,修改php.ini添加扩展配置,重启PHP8.1服务后验证扩展是否加载成功。
三、Nginx配置多PHP版本站点
phpEnv中Nginx通过不同的站点配置来区分不同PHP版本的请求处理,我们需要为每个使用不同PHP版本的项目配置对应的Nginx站点,并且都指向同一个Redis实例。
1. 配置PHP7.4站点
在phpEnv的Nginx站点管理中添加新站点,站点配置文件内容如下:
server {
listen 80;
server_name php74_test.ipipp.com;
root /www/php74_test;
index index.php index.html;
location ~ .php$ {
fastcgi_pass 127.0.0.1:9074; # PHP7.4对应的fastcgi端口
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
2. 配置PHP8.1站点
添加第二个站点,对应PHP8.1版本,配置文件内容如下:
server {
listen 80;
server_name php81_test.ipipp.com;
root /www/php81_test;
index index.php index.html;
location ~ .php$ {
fastcgi_pass 127.0.0.1:9081; # PHP8.1对应的fastcgi端口
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
配置完成后重启Nginx服务,两个站点分别会使用对应的PHP版本处理请求。
四、多PHP版本连接共用Redis实例
两个站点的PHP代码只需要使用相同的Redis连接参数,就可以共用同一个Redis实例。下面是两个版本的测试代码示例。
1. PHP7.4测试代码
在php74_test目录下创建test_redis.php文件,内容如下:
<?php
$redis = new Redis();
// 连接同一个Redis实例,默认端口6379,如果有密码需要添加auth方法
$redis->connect('127.0.0.1', 6379);
// 如果Redis设置了密码,需要添加下面这行
// $redis->auth('redis_password');
$redis->set('php74_key', 'this is php74 data');
echo $redis->get('php74_key');
?>
2. PHP8.1测试代码
在php81_test目录下创建test_redis.php文件,内容如下:
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
// 如果Redis设置了密码,需要添加下面这行
// $redis->auth('redis_password');
// 获取PHP7.4写入的键值
echo $redis->get('php74_key');
$redis->set('php81_key', 'this is php81 data');
?>
分别访问两个站点的test_redis.php文件,PHP8.1的页面会输出PHP7.4写入的内容,说明两个不同PHP版本已经成功共用同一个Redis实例。
五、常见问题排查
- 如果Redis扩展加载失败,检查扩展文件是否和PHP版本匹配,php.ini中的扩展路径是否正确。
- 如果Nginx无法处理PHP请求,检查fastcgi_pass的端口是否和对应PHP版本的监听端口一致,可以在phpEnv的PHP管理中查看每个版本的监听端口。
- 如果Redis连接失败,检查Redis服务是否启动,防火墙是否开放了Redis的6379端口,连接参数是否正确。
通过以上步骤,就可以在phpEnv环境下通过Nginx配置实现多个PHP版本共用一个Redis实例,满足多项目开发的资源复用需求。