php 8.3 原生支持 redis，但 redis.dll/so 必须严格匹配 abi、编译器（如 vc17）和线程模型；命名须为 redis.dll/so（非 php_redis），extension_dir 需绝对路径，nts/ts 版本目录不可混用；依赖缺失或类注册失败（因 zend_module_api_no 不匹配）会导致 module_not_found 或 class not found。
PHP 8.3 原生支持 Redis，但 redis.dll 或 redis.so 扩展必须严格匹配 PHP 8.3 的 ABI、编译器版本和线程模型，否则必然加载失败——这不是配置问题，而是二进制契约失效。
php -m 看不到 redis 模块？先确认扩展名和路径是否被正确识别
PHP 8.3 不再容忍旧版命名或路径模糊写法。常见错误包括：
-
extension=php_redis.dll—— 错误：PHP 8.3 要求扩展名必须为redis.dll（Windows）或redis.so（Linux），带php_前缀的旧命名会被拒绝加载 -
extension_dir = "ext"未设绝对路径 —— 在某些环境（如 PHPStudy）下相对路径会解析失败，建议显式写成extension_dir = "D:\phpstudy_pro\extensions\php\php8.3.0-nts\ext" - 扩展文件放在了错误目录 —— NTS 版本必须用
php8.3.0-nts\ext\，TS 版本则对应php8.3.0-ts\ext\，混放必报module_not_found（错误码 0x7e）
Windows 下 redis.dll 加载报 “找不到指定的模块” 怎么办
这个错误 90% 不是路径错，而是依赖缺失或 ABI 不匹配。关键检查点：
- 确认 PHP 是 VC17 编译（
php -v输出含VC17字样），则redis.dll必须由 VS2022 v17.x 编译，VS2019（VC16）或 MinGW 编译的 DLL 一律拒载 - 用 Dependencies 工具打开
redis.dll，查看是否缺失vcruntime140_1.dll或msvcp140.dll—— 缺失即需安装 Microsoft Visual C++ 2022 Redistributable (x64) - 检查
php.ini中是否启用了extension=redis（不带后缀），且该行未被注释；同时确保没有重复启用（如既有extension=redis又有extension=redis.dll）
Linux 下用 pecl install redis 失败或加载不了
PECL 官方尚未为 PHP 8.3 提供预编译包，pecl install redis 默认会尝试编译，但极易因环境差异失败：
- 必须先装
php-dev和php-pear，且php-config路径要与当前 PHP 一致（如/usr/bin/php-config8.3） - 编译时若报
fatal error: zend_modules.h: No such file or directory，说明头文件路径不对，需加--with-php-config=/usr/bin/php-config8.3 - 生成的
redis.so若仍无法加载，运行ldd /path/to/redis.so | grep "not found"查缺失的系统库（常见如libz.so.1、libsodium.so.23） - CentOS/Rocky Linux 用户推荐用 Remi 源：
yum install php-pecl-redis83，比手动编译稳定得多
为什么 phpinfo() 显示已加载，但 new Redis() 报 class not found
这是最隐蔽的坑：扩展虽加载成功，但类注册失败。典型原因只有两个：
-
redis.so/redis.dll文件本身是为 PHP 8.2 编译的，虽然能加载进进程，但zend_register_internal_class调用因zend_module_api_no不匹配（PHP 8.3 是20230831）而静默跳过类注册 - 扩展被其他扩展干扰（如
ioncube或sourceguardian在早期初始化阶段劫持了类表），此时需调整php.ini中extension=的顺序，把redis放在它们之后
验证方法：执行 php --ri redis，若输出中不含 Redis Support => enabled 和 Registered save handlers => files user redis，就说明类没注册上，不是代码问题，是扩展二进制本身不兼容。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
