ThinkPHP 6.x 缓存驱动默认使用 serialize() 序列化,非 JSON;虽支持对象完整结构但存在跨语言不兼容、反序列化风险及 PHP 版本升级失效等问题,建议按需改用 json_encode()/json_decode() 并注意数据类型丢失与标签缓存兼容性。

ThinkPHP缓存驱动默认用什么序列化?
ThinkPHP 6.x 默认使用 serialize()(PHP 原生串行化),不是 JSON。这点容易被误以为是 JSON,尤其当你在 Redis 或 File 缓存里看到乱码或二进制内容时——那大概率就是 serialize() 的结果。
它能保留对象、资源、闭包等完整结构,但代价是:跨语言不兼容、PHP 版本升级可能反序列化失败、Redis 中不可读、且存在反序列化安全风险(尤其缓存内容可控时)。
关键判断:除非你明确依赖对象重建(比如缓存了带方法的查询构建器实例),否则建议切到 json_encode()。
怎么改缓存序列化为 JSON?
ThinkPHP 不提供全局“切换序列化方式”的开关,而是靠自定义缓存驱动或重写序列化逻辑。最稳妥的做法是继承原驱动并覆盖 serialize() 和 unserialize() 方法。
以 Redis 驱动为例(think\cache\driver\Redis):
- 新建类
app\cache\driver\JsonRedis,继承think\cache\driver\Redis - 重写
serialize():用json_encode($value, JSON_UNESCAPED_UNICODE)替代父类逻辑 - 重写
unserialize():用json_decode($data, true),并加空值/失败兜底(json_last_error() === JSON_ERROR_NONE) - 在
config/cache.php中把default驱动指向你这个新类,或单独配一个json_redis类型
注意:File 驱动同理,但需同步修改 getCacheKey() 行为(JSON 后键名不变,但值内容变,不影响)。
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
JSON 序列化会丢什么数据?
JSON 不能表示 PHP 中的以下类型,会静默转成 null 或被忽略:
- 资源(resource),如文件句柄、PDO 连接
- 闭包(Closure)
- 对象中含不可遍历属性(private/protected 成员若未实现
JsonSerializable) - NaN、INF、-INF(PHP 7.4+ 会报错,低版本转成
null) - 数组键为浮点数或负数(JSON 只支持字符串键,PHP 会强转)
所以别缓存 new \DateTime() 或 fopen() 结果——它们 JSON 化后只剩空数组或 null。如果业务真需要对象状态,得手动实现 toArray() 再缓存。
性能和兼容性差异有多大?
JSON 比 serialize() 快约 20%~40%,内存占用略低,但差距在毫秒级,一般不是瓶颈。真正影响大的是兼容性:
- Redis CLI 里能直接
GET看清缓存值,调试方便 - 和其他语言服务共用缓存时(比如 Go 读 PHP 写的缓存),JSON 是唯一可行方案
- PHP 升级(如 8.0 → 8.1)不会导致旧缓存无法反序列化(
serialize()在类结构变动时极易崩) - 禁用
unserialize()也能规避部分反序列化漏洞面
不过,如果你项目里大量用了 Cache::remember('key', 3600, function () { return new SomeService(); }),且 SomeService 没实现 JsonSerializable,那切 JSON 后缓存值就变成 {}——这种隐式失效最难排查。
最常被忽略的一点:ThinkPHP 的 TagSet(标签缓存)底层也走同一套序列化逻辑。你改了驱动,但没重写 tagSet() 相关方法,标签匹配可能出错。实际改法得连带检查 getTagItem() 和 setTagItem() 是否还依赖原序列化格式。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










