必须先启用php原生redis扩展（php -m | grep redis验证），再安装topthink/think-redis包；缺扩展则redis类不存在，后续所有tp6配置均无效。

这是 PHP 环境层面缺失 Redis 扩展导致的，不是 ThinkPHP 配置问题。类 Redis 是 PHP 原生扩展提供的，TP6 只是调用它。只要这个类不存在，后续所有驱动注册、配置都无效。

确认并启用 PHP redis 扩展

执行命令检查是否已加载：

• php -m | grep redis（Linux/macOS）
• Windows 用户打开 phpinfo() 页面，搜索 “redis” 模块是否存在

若无输出，说明扩展未安装或未启用：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• 用 pecl install redis 安装（推荐）
• 或手动下载对应 PHP 版本和线程安全（TS/NTS）的 php_redis.dll（Windows）或 redis.so（Linux）
• 在 php.ini 中添加：extension=redis.so 或 extension=php_redis.dll
• 重启 Web 服务（Apache/Nginx）和 PHP-FPM 进程

检查扩展与 PHP 版本严格匹配

常见坑：PHP 8.3 装了 PHP 7.x 编译的 dll，会导致扩展加载失败，php -m 看不到 redis，但也不报错。

• 运行 php -v 查看确切版本（如 PHP 8.3.10）
• 去 pecl.php.net 下载对应版本、架构（x64/x86）、线程模型（TS/NTS）的扩展
• Windows 用户特别注意：IIS 或小皮面板等集成环境可能使用独立 php.ini，需确认修改的是被实际加载的那个

验证类存在且可被自动加载

扩展启用后，终端执行：

• php -r "new Redis(); echo 'OK';" —— 应输出 OK，否则扩展未生效
• 再执行 composer require topthink/think-redis（TP6 官方 Redis 驱动适配器）
• 检查 vendor/topthink/think-redis/src/Driver.php 是否存在
• 确保 composer.json 中已写入 "topthink/think-redis": "^3.0"

排除其他干扰项

某些情况看似报错相同，实则另有原因：

• 误装 predis/predis 或 phpredis/phpredis —— 这些是客户端库或旧包名，不能替代 PHP 原生 redis 扩展
• Swoole 或命令行任务中，因 autoloader 加载顺序问题导致类找不到：可尝试在启动脚本开头加 class_exists('Redis') 主动触发检测
• Docker 环境需确认基础镜像已安装扩展（如 php:8.3-cli 不自带 redis，需额外 docker-php-ext-install redis）

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！