为什么宝塔面板PHP安装扩展Redis后不生效_检查php.ini配置加载路径与重启PHP服务-php教程-PHP中文网

PHP实际加载的php.ini路径以phpinfo()中“Loaded Configuration File”为准，而非宝塔界面显示路径；需确认FPM对应php.ini中正确启用extension=redis.so，并重启PHP-FPM服务后验证extension_loaded('redis')返回true。

为什么宝塔面板php安装扩展redis后不生效_检查php.ini配置加载路径与重启php服务

确认 PHP 实际加载的 `php.ini` 文件路径

宝塔面板里点“PHP 设置”看到的 php.ini 路径，不一定是 PHP 运行时真正读取的那个。常见原因是 CLI 和 Web SAPI（如 FPM）用的是不同配置文件，而 Redis 扩展装完后只写入了其中一个。

直接在网站根目录放一个 info.php，内容为，浏览器访问它，搜索 “Loaded Configuration File”，看实际加载的是哪个 php.ini。别信宝塔界面显示的路径，以这个为准。

如果用的是 PHP-FPM（绝大多数网站场景），重点看 FPM 对应的 php.ini，通常在 /www/server/php/{版本号}/etc/php.ini
CLI 下运行 php -i | grep "Loaded Configuration File" 显示的是命令行路径，和网页无关
宝塔有时会把扩展配置单独拆到 ext-redis.ini 放在 php.d/ 目录下，得确认该目录是否被主 php.ini 通过 include_path 或 scan_dir 加载

检查 `extension=redis.so` 是否写对且位置正确

Redis 扩展不是靠“安装成功”就自动生效的，必须在正确的 php.ini 里显式启用。宝塔有时会漏写、写错路径，或加在被注释掉的区域后面。

打开上一步确认的 php.ini，搜索 redis，确保有且仅有一行未被注释的：extension=redis.so（PHP 7.x/8.0+）或 extension=redis（极老版本，已淘汰）。

不要写成 extension=/www/server/php/.../redis.so —— 绝对路径容易出错，用相对名即可，PHP 会自动在 extension_dir 下查找
确认 extension_dir 指向正确目录，比如 /www/server/php/{版本号}/lib/php/extensions/no-debug-non-zts-20220829/（具体后缀随 PHP 版本变）
如果同时启用了 opcache，extension=redis.so 应放在 opcache 配置之后，避免某些旧版冲突

重启服务顺序不能错：先 PHP-FPM，再 Web 服务器

改完 php.ini 后只点“重载配置”或只重启 Nginx/Apache，Redis 扩展依然不会生效。PHP-FPM 进程不重启，加载的还是旧模块列表。

在宝塔面板中操作顺序必须是：

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

进入“软件商店” → 找到对应 PHP 版本 → 点击“设置” → “服务” → “停止”，再点“启动”（等价于 systemctl restart php-fpm-{版本号}）
然后再重启 Nginx 或 Apache（否则即使 PHP 加载了 Redis，Web 请求也进不来）
不要依赖“重载配置”按钮——它只发 reload 信号，不重建 PHP 进程，扩展变更不生效

验证 Redis 扩展是否真加载成功

别只看宝塔“已安装”绿勾，也不单靠 php -m | grep redis（它查的是 CLI 环境）。要模拟真实请求环境验证。

在网站目录下运行：

php -r "var_dump(function_exists('redis_connect'));"

或更准一点：

php -r "var_dump(extension_loaded('redis'));"

返回 bool(true) 才算成功。如果返回 false，再回退检查前三个步骤。

常见干扰项：PHP 多版本共存时，php 命令可能指向另一个版本，务必用完整路径测试，例如 /www/server/php/80/bin/php -r "var_dump(extension_loaded('redis'));"
如果 phpinfo() 页面里看不到 Redis 模块区块，说明没加载；能看到但 extension_loaded() 返回 false，可能是扩展与 PHP 版本 ABI 不兼容（比如用 PHP 8.1 编译的 redis.so 强行塞进 PHP 8.2）

最易被忽略的一点：宝塔升级 PHP 后，旧的 redis.so 文件可能还在，但新版 PHP 的 extension_dir 已变，或 ABI 不匹配，此时必须重新编译或从宝塔“PHP 扩展”页重装 Redis。