redis hash 存储业务数据必须使用 phpredis 扩展，因 predis 不支持 hset 等原生命令完整语义；需确认 php -m 输出 redis，配置中 password 必须为 null，key 命名统一前缀，field 避免使用 . : * 等符号。
Redis Hash 存储业务数据必须用 phpredis，不能用 predis
ThinkPHP 6 默认的 redis 缓存驱动依赖 phpredis 扩展，而 predis（纯 PHP 实现）不支持 HSET、HGETALL 等原生命令的完整语义，尤其在字段级更新、原子递增等场景会出错或静默失败。运行 php -m | grep redis，输出必须是 redis，不是 predis 或空。若无输出，需安装 phpredis 并重启 PHP 进程；Windows 下检查 php.ini 是否启用了 extension=php_redis.dll，Linux 下确认 extension=redis.so 已加载。
ThinkPHP 6 中直接操作 Redis Hash 的两种方式
一种是通过底层 Redis 实例调用原生命令，另一种是封装成可复用的工具类（如知识库中提到的 RedisHash）。推荐前者用于快速验证和简单逻辑，后者用于多处复用、避免重复拼接 key。
- 直接使用
cache()->store('redis')->handler()获取原生Redis对象，再调用hSet()、hGetAll()、hIncrBy()等方法 -
hSet('user:1001', 'login_ip', '192.168.1.5')写入单个字段，比全量序列化更轻量 -
hMSet('user:1001', ['last_login_time' => time(), 'status' => 'active'])一次性写多个字段 -
hGet('user:1001', 'login_ip')读单个字段，避免反序列化整个用户对象 - 注意：key 命名建议统一前缀 + 业务标识（如
user:、order:），避免键冲突
password 为空时必须显式设为 null，否则连接失败
在 config/cache.php 的 stores.redis 配置中，password 字段不能留空字符串 ''，也不能省略。必须写成 'password' => null。否则 phpredis 会尝试以空密码认证，Redis 服务端若配置了 requirepass，就会拒绝连接并报错 NOAUTH Authentication required。同时确认 host、port、select（数据库编号）都正确，特殊字符密码需 URL 编码。
字段名含点号或冒号时要小心 key 解析歧义
Redis Hash 本身不限制 field 名称，但 ThinkPHP 的缓存标签、中间件或自定义驱动若对 key 做了正则解析（比如按 : 分割层级），就可能把 user:1001.login_time 当成两级 key 处理。实际业务中应避免在 field 中使用 .、:、* 等符号。如需表达嵌套结构，改用下划线，例如 login_time、profile_status。另外，field 名区分大小写，email 和 Email 是两个不同字段，容易因拼写不一致导致读不到数据。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
