因为PHP加载扩展时严格校验文件名后缀,extension=redis会让PHP寻找redis(无后缀)或redis.dll,而Linux下真实文件是redis.so,省略.so导致静默失败,既不报错也不加载。

extension=redis.so 为什么写成 extension=redis 就不生效
因为 PHP 加载扩展时严格校验文件名后缀,extension=redis 实际会让 PHP 去找 redis(无后缀)或 redis.dll(Windows 下),而 Linux 下真实扩展文件名是 redis.so。写错后缀会导致静默失败——既不报错,也不加载,php -m 里看不到,extension_loaded('redis') 返回 false。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 永远用
extension=xxx.so格式,不要省略.so - 确认扩展文件确实存在于
extension_dir指向的目录下(可用ls -l $(php -r "echo ini_get('extension_dir');")查看) - 如果用了绝对路径(如
extension=/www/server/php/81/lib/php/extensions/no-debug-non-zts-20210902/redis.so),必须确保路径中 API 子目录名(如20210902)与当前 PHP 的PHP_API_VERSION完全一致,否则仍会加载失败
宝塔面板里勾选了 Redis,但 phpinfo() 里还是没看到模块
宝塔界面上的“勾选”只是修改了它管理的某个 php.ini 文件,但 PHP-FPM 实际加载的可能是另一个。尤其当站点绑定了特定 PHP 版本,而你改的是 CLI 或其他版本的配置时,就会出现「界面显示已启用,实际没生效」。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 在网站根目录建
info.php,内容为<?php phpinfo(); ?>,浏览器访问,搜索Loaded Configuration File,拿到 Web 环境真正读的php.ini路径 - 同时终端执行
php --ini,对比 CLI 加载的是哪个php.ini,两者通常不同 - 只改
Loaded Configuration File对应的那个文件,在末尾加extension=redis.so(注意:不要重复添加,避免冲突) - 改完必须点宝塔里对应 PHP 版本的「重启服务」,不是「重载配置」——重载不触发模块重新初始化
extension=redis.so 写对了,extension_dir 也对,但调用 imagecreatefrompng() 还是报错
这说明扩展虽然加载成功(php -m 可见、extension_loaded() 返回 true),但内部函数未注册。典型原因是编译时系统依赖缺失,比如 GD 扩展没装 libpng-dev 或 libjpeg-dev,configure 阶段跳过了 PNG/JPEG 支持,最终生成的 gd.so 里压根没有 imagecreatefrompng 符号。
验证方式:
- 执行
php -r "print_r(get_extension_funcs('gd'));",如果输出里没有imagecreatefrompng,基本可断定是编译裁剪导致 - 回看当时编译日志,搜
checking for PNG support... no这类提示 - 补装系统依赖:
apt install libpng-dev libjpeg-dev libfreetype6-dev(Debian/Ubuntu),再重新编译安装 GD
多个 php.ini 文件共存时,extension 配置被覆盖或忽略
PHP 启动时按顺序加载主 php.ini + Scan for additional .ini files in 目录下的所有 *.ini 文件。如果某个后加载的 ini 文件里写了 extension=opcache.so,而前面已有 extension=redis.so,看似没问题;但如果 opcache 的 ini 文件里有 zend_extension=... 或启用了 opcache.enable=0,某些旧版 PHP 会因初始化顺序问题导致后续扩展无法注册函数。
排查重点:
- 执行
php --ini,记下Scan for additional .ini files in路径(如/www/server/php/81/etc/php.d/) - 检查该目录下是否有其他扩展的 ini 文件,尤其是
opcache.ini、apcu.ini这类 Zend 扩展 - 临时重命名这些额外 ini 文件(如
mv opcache.ini opcache.ini.bak),再重启 PHP,观察问题是否消失 - 若确认是冲突,优先保证
extension=类配置放在主php.ini末尾,zend_extension=类放在开头



















