PHP 8.3 要求 extension=redis（不带后缀），且必须严格匹配 ABI、VC17 编译器、TS/NTS 线程模型及 x64 架构；extension_dir 需为绝对路径，依赖缺失或 zend_module_api_no 不匹配会导致静默失败或 class not found。
php.ini 中 extension=redis 加载失败，但扩展文件明明存在
这不是配置漏写或路径错位的问题，而是 PHP 8.3 对扩展加载契约做了硬性升级：它拒绝识别 extension=php_redis.dll 或 extension=redis.so 这类带后缀或前缀的写法。必须严格写成 extension=redis（不带任何后缀），且该行不能被注释、不能重复出现。
常见错误包括：
-
extension=php_redis.dll→ Windows 下直接跳过加载，php -m看不到 redis -
extension=redis.so→ Linux 下报Invalid library (maybe not a PHP library) - 同一 php.ini 里同时存在
extension=redis和extension=redis.so→ 后者触发 ABI 冲突，导致module_not_found错误码 0x7e -
extension_dir是相对路径（如"ext"）→ PHP 8.3 在某些环境（如 PHPStudy、小皮面板）下无法解析，必须用绝对路径，例如extension_dir = "D:\phpstudy_pro\Extensions\php\php8.3.0-nts\ext"
Windows 下 redis.dll 报“找不到指定的模块”
立即学习“PHP免费学习笔记（深入）”；
这个错误 90% 不是 PHP 找不到 DLL，而是 DLL 自身缺依赖或 ABI 不匹配。PHP 8.3（尤其是 NTS 版本）基本都由 VC17 编译，意味着你用的 redis.dll 必须也是 VS2022 v17.x 编译的产物。
检查步骤：
- 运行
php -v，确认输出含VC17字样；若为VC16，说明你装的是 PHP 8.2 兼容包，不是 8.3 正式版 - 用 Dependencies 工具打开
redis.dll，重点看是否缺失vcruntime140_1.dll或msvcp140.dll—— 缺失就装 Microsoft Visual C++ 2022 Redistributable (x64) - 确认 DLL 放在了对应线程模型目录：
php8.3.0-ntsext（非线程安全）或php8.3.0-tsext（线程安全），混放必报错 - 不要手动修改 DLL 名称（如重命名为
redis_new.dll），PHP 8.3 会校验模块名与内部注册名是否一致
Linux 下 pecl install redis 失败或 extension=redis 不生效
PECL 官方尚未为 PHP 8.3 提供预编译包，pecl install redis 实际执行的是源码编译，极易因头文件路径、依赖库版本或编译器标准失败。
关键动作：
- 先装对版本的开发包：
apt install php8.3-dev（Ubuntu/Debian）或yum install php83-php-devel（Rocky/CentOS + Remi 源） - 确保
php-config路径正确：运行which php-config8.3，然后在 configure 阶段显式指定：./configure --with-php-config=/usr/bin/php-config8.3 - 编译后检查
redis.so依赖：ldd /path/to/modules/redis.so | grep "not found"，常见缺失项包括libz.so.1、libsodium.so.23 - 更稳方案是跳过 PECL，直接用系统包管理器安装：
yum install php-pecl-redis83（Remi 源），它已预编译适配 ABI 和 PHP 8.3 的 opcache/pcre3 行为
最常被忽略的一点：PHP 8.3 的扩展加载过程会在模块初始化阶段校验 zend_module_api_no，哪怕 DLL/SO 文件能加载，只要这个 ABI 号不匹配（比如用了 PHP 8.2 编译的 redis.so），就会静默跳过类注册，最终表现为 class Redis not found —— 此时 php -m 仍显示 redis，但实际不可用。
