如何在ThinkPHP缓存中存储对象数据_序列化与JSON反序列化驱动策略选择-ThinkPHP-PHP中文网

必须用 serialize()。ThinkPHP 默认缓存驱动不预处理数据，json_encode() 会丢失类方法、私有属性和资源句柄，导致取回后无法调用对象方法；仅当需跨语言共享且接受对象退化为数组时才考虑 JSON。

如何在thinkphp缓存中存储对象数据_序列化与json反序列化驱动策略选择

ThinkPHP 缓存里存对象，直接 `serialize()` 还是 `json_encode()`？

必须用 serialize()。ThinkPHP 的默认缓存驱动（如 File、Redis、Memcached）底层对值不做预处理，直接存入；如果手动用 json_encode() 存对象，取出来只是数组或 stdClass，原始类方法、私有属性、资源句柄全丢光，unserialize() 也救不回来。

常见错误现象：Cache::get('user') 返回一个看似正常的数组，但调用 ->getName() 报错 “Call to undefined method stdClass::getName()”。

只有实现了 JsonSerializable 接口且你明确只要数据结构（不要行为）时，才考虑 JSON
serialize() 保留完整对象状态，包括 private/protected 属性、类名、自动触发 __sleep()/__wakeup()
JSON 不支持资源类型（如 cURL 句柄、数据库连接）、闭包、循环引用，序列化可以（部分驱动下）

Redis 驱动下存对象，为什么有时 `unserialize()` 失败？

因为 Redis 缓存驱动默认启用 serialize 序列化，但如果你手动改过配置项 serialize 或用了第三方扩展，可能被悄悄切到 JSON 模式——这时候存的是字符串，取出来却是乱码或空值。

检查点：cache.php 中的 'serialize' => true 必须存在且为 true；Redis 驱动内部会用 serialize() + base64_encode() 包一层防二进制污染，取时自动反向解包。

别自己在 set() 前再套一次 serialize()，会导致双重序列化，get() 取出来还是字符串
确认 php.ini 中 unserialize_callback_func 未禁用，否则类不存在时静默失败
ThinkPHP 6.1+ 对 Redis 驱动做了类型标记（加前缀 s:），升级后老缓存可能无法识别，需清空

File 驱动存对象，文件变大且读取变慢，怎么优化？

File 驱动把序列化后的字符串直接写进文件，没压缩、没索引，对象带大量冗余信息（类名、命名空间、属性键名）时体积膨胀明显，尤其含长文本或嵌套数组。

不是所有对象都适合缓存——比如带 DateTime 实例、Collection 对象，它们序列化后字段多；优先缓存精简后的数组（$obj->toArray()），而非原始对象。

用 __sleep() 显式声明只序列化必要属性，避免保存临时计算字段或连接实例
避免缓存 Laravel 风格的 Eloquent Model 实例（TP 的 Model 同理），它们自带查询构建器、事件监听器等重量级成员
File 驱动本身不支持过期时间原子操作，大对象 + 高频读写容易引发 IO 竞态，换 Redis 更稳

自定义缓存驱动时，`serialize` 和 `json` 要怎么选？

看下游系统是否能理解 PHP 原生序列化格式。如果是纯 TP 内部使用，无条件选 serialize；如果要和 Node.js/Python 共享缓存，就必须用 json，但得接受对象退化为数组的事实。

TP 6.x 的 TagSet 机制依赖序列化标识对象来源，一旦切 JSON，标签失效、清除逻辑就断掉。

不要在驱动里混用：不能存 JSON、取时用 unserialize()，也不能存 serialize、取时 json_decode()
若必须跨语言，建议在业务层统一转成标准数组（toArray()），再由缓存驱动按需编码，而不是让驱动承担序列化职责
TP 的 Cache::remember() 默认走原生序列化，自定义驱动若返回非字符串值（如数组），会直接报错 “Cache data must be string”

真正麻烦的不是选哪个函数，而是对象里有没有隐式依赖外部状态——比如某个属性是 Closure，或者持有一个未实现 Serializable 接口的第三方 SDK 实例。这种时候，序列化会静默失败，日志里只留一条 “failed to write cache”，得去翻 error_log 才能看到 Serialization of 'Closure' is not allowed。