宝塔PHP安装Redis扩展教程

本文详细介绍了在宝塔面板中为指定PHP版本（如7.4、8.1等）手动编译安装Redis扩展的完整流程——从精准定位PHP安装路径、验证phpize工具，到下载适配源码、用对应php-config编译生成redis.so，再到修改php.ini启用扩展并重载服务，最后通过PHP函数验证加载成功；步骤清晰、路径明确、避坑提示到位，特别适合多PHP版本共存环境下需精准启用Redis支持的运维人员和开发者快速上手、一次配置成功。

如果您在宝塔面板中已安装多个PHP版本，但需要为其中某个特定PHP版本启用Redis扩展，则需手动编译安装该扩展。以下是针对指定PHP版本安装Redis扩展组件的操作步骤：

一、确认目标PHP版本及路径

安装前需明确要操作的PHP版本号及其安装路径，避免误操作其他版本。宝塔面板中不同PHP版本独立存放，扩展必须对应其phpize和php-config工具。

1、登录宝塔面板，进入【软件商店】→【已安装】，找到目标PHP版本（如PHP 7.4、PHP 8.1等），点击【设置】。

2、在【配置文件】选项卡中，记下PHP安装路径，通常为/www/server/php/74（以PHP 7.4为例，数字部分随版本变化）。

3、通过SSH连接服务器，执行命令确认phpize路径：/www/server/php/74/bin/phpize，若返回“Configuring for”信息则路径有效。

二、下载并编译Redis扩展源码

Redis扩展需从官方GitHub仓库获取与PHP版本兼容的稳定版源码，并使用对应PHP版本的构建工具编译生成so文件。

1、进入临时目录：cd /www/server/php/src（若不存在则创建：mkdir -p /www/server/php/src）。

2、下载Redis扩展源码（以最新稳定版v5.3.7为例，适用于PHP 7.4–8.2）：wget https://github.com/phpredis/phpredis/archive/refs/tags/5.3.7.tar.gz。

3、解压并进入源码目录：tar -xzf 5.3.7.tar.gz && cd phpredis-5.3.7。

4、调用目标PHP版本的phpize初始化编译环境：/www/server/php/74/bin/phpize。

5、配置编译参数，指定PHP配置文件路径：./configure --with-php-config=/www/server/php/74/bin/php-config。

6、编译并安装：make && make install。成功后会输出类似“Installing shared extensions: /www/server/php/74/lib/php/extensions/no-debug-non-zts-20200930/”的路径。

三、启用Redis扩展并重启服务

编译生成的redis.so文件需写入对应PHP版本的配置文件，并重启PHP服务使扩展生效。

1、查看PHP扩展目录路径，确认redis.so已存在：ls -l /www/server/php/74/lib/php/extensions/no-debug-non-zts-*，从中找到redis.so文件。

2、编辑该PHP版本的配置文件：vi /www/server/php/74/etc/php.ini。

3、在文件末尾新增一行：extension=redis.so。

4、保存退出后，在宝塔面板中进入该PHP版本【设置】→【服务】→【重载配置】，或执行命令：/etc/init.d/php-fpm-74 reload（数字需与版本一致）。

四、验证Redis扩展是否加载成功

扩展启用后需通过PHP函数检测其是否被正确识别和初始化，避免因路径错误或依赖缺失导致静默失败。

1、创建测试文件：echo " /www/wwwroot/test-redis.php。

2、通过浏览器访问该文件URL（如http://您的域名/test-redis.php），应返回bool(true)。

3、进一步确认类可用性：echo " /www/wwwroot/test-redis-class.php，访问后应同样返回bool(true)。

理论要掌握，实操不能落！以上关于《宝塔PHP安装Redis扩展教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！