宝塔面板PHP 8.x一键安装Redis扩展失效，因官方无适配预编译包、脚本不兼容ZTS/NTS及phpize路径错误；须手动用pecl编译redis-5.3.7+并配置php.ini启用。
宝塔面板对 PHP 8.x（包括 8.0、8.1、8.2 等）安装 Redis 扩展的「一键安装」功能基本不可用，尤其是 PHP 8.0 起，官方预编译包缺失、构建脚本不兼容 ZTS/NTS 模式、phpize 路径错位等问题会导致点击安装后卡住、报错或静默失败。必须绕过图形界面，手动编译安装。
为什么宝塔的“安装扩展”按钮在 PHP 8.x 上失效
宝塔内置扩展仓库中默认未启用 redis 模块；其一键脚本仍沿用旧版逻辑，无法识别 PHP 8.x 的 phpize 路径（如 /www/server/php/80/bin/phpize）、不校验 PHP_VERSION_ID、也不处理 ZTS 兼容性。即使触发安装，也常因缺少 autoconf、pkg-config 或头文件路径错误而中断。Redis 扩展从 5.3.7 版本起才正式支持 PHP 8.0+，旧版（如 5.3.4）直接编译失败。
正确做法：用终端手动编译安装（推荐）
确保已安装基础编译工具：
- CentOS/Alibaba Cloud Linux：yum install -y gcc make autoconf pkgconfig
- Ubuntu/Debian：apt install -y build-essential autoconf pkg-config
执行以下命令（以 PHP 8.0 为例，其他版本请替换 /80 为对应目录名，如 /82）：
立即学习“PHP免费学习笔记（深入）”；
- cd /tmp && wget https://pecl.php.net/get/redis-5.3.7.tgz
- tar xzf redis-5.3.7.tgz && cd redis-5.3.7
- /www/server/php/80/bin/phpize
- ./configure --with-php-config=/www/server/php/80/bin/php-config
- make && make install
安装成功后，检查文件是否存在：
ls /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/redis.so
若输出该文件路径，说明编译完成。
配置并启用扩展
编辑对应 PHP 版本的 php.ini 文件（可通过宝塔面板 → PHP 设置 → 配置文件打开）：
- 确认 extension_dir 指向正确的目录（如 /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/）
- 在文件末尾添加：extension=redis（注意：不要写 .so，PHP 8.0+ 支持自动补全）
- 保存后，重启对应 PHP 服务（宝塔中点击「重载配置」或「重启」）
验证是否生效：
在终端运行 php -m | grep redis，有输出即表示加载成功；也可新建 PHP 文件调用 phpinfo() 查看 Redis 模块信息。
常见失败原因与快速排查
- php-config 找不到或版本不对：运行 /www/server/php/80/bin/php-config --version，必须输出 8.0.x
- make install 报错 “No rule to make target 'install'”：通常是 phpize 未成功执行，或源码目录下缺少 configure 脚本（可先运行 autoreconf -ivf）
- php -m 不显示 redis：检查 extension_dir 是否与 redis.so 实际路径一致；确认 json 和 sockets 扩展已启用（Redis 依赖这两者）
- new Redis() 报类不存在：说明扩展未加载成功，不是代码问题，优先查 php -m 和 error_log
