数组可直接缓存,对象必须由框架自动序列化;数组无需处理,对象禁用json_encode,file驱动需精简数据,redis驱动需确保serialize配置正确且不手动序列化。

ThinkPHP 5 缓存存储数组和对象,核心区别在于序列化方式是否匹配框架默认行为。数组可直接存,对象必须用 serialize(),不能用 json_encode()。
存数组:直接传入,无需额外处理
数组是 PHP 原生可序列化的标量结构,TP5 各缓存驱动(File、Redis、Memcached)在写入时会自动调用 serialize()(File 驱动)或依赖驱动自身序列化逻辑(如 Redis 默认启用 serialize)。你只需:
Cache::set('user_list', [['id'=>1,'name'=>'张三'], ['id'=>2,'name'=>'李四']], 3600);- 取回后仍是原样数组,
foreach、array_column等操作完全可用 - 若用
cache('user_list', $data)助手函数,效果一致
存对象:必须依赖框架自动序列化,禁止手动 json_encode
对象含类名、私有/保护属性、方法、资源句柄等,json_encode() 会丢失全部行为信息,仅剩扁平数组或 stdClass,导致取回后无法调用方法(如 ->getName() 报错)。
- 正确做法:直接传对象实例,由 TP5 驱动内部处理
$user = new User(); $user->setId(100)->setName('王五'); Cache::set('current_user', $user, 3600); - 框架默认对 File/Redis/Memcached 驱动启用
serialize(),能完整保留类信息、属性可见性、__sleep()/__wakeup()钩子 - 切勿自己先
json_encode($obj)再存——这会让对象“退化”,且unserialize()无法还原
File 驱动下存大对象的优化建议
File 驱动把序列化字符串直写文件,对象越复杂(如含 DateTime、Collection、关联模型),缓存文件越大、读取越慢。
- 优先缓存精简数据:
Cache::set('user_simple', $user->toArray(), 3600); - 在对象中定义
__sleep(),只序列化必要字段:public function __sleep() { return ['id', 'name', 'email']; } - 避免缓存带数据库连接、事件监听器的 Model 实例(如 TP 的
Db::name('user')->find()返回值) - 确认
config/cache.php中 File 驱动的'path'目录可写,且路径为绝对路径(如runtime/cache/)
Redis 驱动存对象的注意事项
Redis 驱动默认开启 serialize 并加 base64 包装,但配置错误易导致失败。
- 检查
config/cache.php中对应 Redis store 的'serialize' => true是否存在且为true - 不要在
set()前手动serialize(),否则取回的是双重序列化的字符串 - 升级到 TP6.1+ 后,旧 Redis 缓存可能因类型前缀变更(如加
s:)无法识别,需清空重来 - 确保
php.ini中未禁用unserialize_callback_func,否则类未加载时静默失败
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











