S函数在ThinkPHP 5.1+中被彻底移除，因其硬编码路径、无驱动抽象、不支持TTL和标签；须用Cache::get()/set()替代，并注意参数拆分、键名格式及驱动差异。
ThinkPHP 5.1+ 中 S 函数为什么不能用了
S 是 ThinkPHP 3.x 时代的全局缓存快捷函数，底层直接操作文件缓存，硬编码路径、无驱动抽象、不支持 TTL 和标签等现代缓存特性。从 ThinkPHP 5.1 开始，S 被彻底移除——不是“弃用警告”，而是源码里直接删了。如果你升级后遇到 Call to undefined function S()，说明项目里还残留着大量 S('key') 调用，必须替换。
用 Cache::get() 和 Cache::set() 替代 S() 的基本写法
ThinkPHP 5.1+ 统一使用 think\Cache 类（或门面 think\Cache）提供驱动化缓存。默认已注册门面，可直接用静态调用：
// 原来 TP3.x 写法
S('user_123', $data, 3600);
// 现在 TP5.1+ 写法（推荐门面方式）
\think\Cache::set('user_123', $data, 3600);
$data = \think\Cache::get('user_123');
// 如果已 use think\Cache; 则更简洁
Cache::set('user_123', $data, 3600);
Cache::get('user_123');
注意：Cache::get() 查不到时返回 null，和旧版 S() 行为一致；但 Cache::set() 第三个参数是秒级 TTL，不传则使用配置中默认 default_expire（通常为 3600），不是永久缓存。
批量迁移时要注意的兼容性坑
直接全局替换 S( → Cache::get( 会出错，因为 S 是双功能函数（读/写合一），而 Cache 拆成了两个方法。需按上下文区分：
立即学习“PHP免费学习笔记（深入）”；
- 单参数
S('key')→ 改为Cache::get('key') - 三参数
S('key', $value, $time)→ 改为Cache::set('key', $value, $time) - 两参数
S('key', $value)（无过期）→ 改为Cache::set('key', $value, null)或留空第三个参数（依赖配置） - 旧版
S支持数组键名如S(['user','123'])→Cache不支持，必须拼成字符串'user_123'或用命名空间前缀
另外，Cache 默认驱动是 File，路径在 runtime/cache/，和旧版 Runtime/Data/_fields/ 完全不同，不要指望缓存能自动延续。
如何让老代码“无感”过渡（临时兼容层）
如果项目大、调用分散，又没时间逐个改，可以在 app/common.php 或启动文件里手动补一个兼容函数：
if (!function_exists('S')) {
function S($key, $value = null, $expire = null) {
if (is_null($value)) {
return \think\Cache::get($key);
}
return \think\Cache::set($key, $value, $expire);
}
}
这样保留了原签名，但底层走的是新驱动。不过要注意：
- 该函数无法支持旧版
S的「缓存标签」和「多维数组键」逻辑 - 如果项目已切换到 Redis 驱动，这个
S就会走 Redis，行为和原来文件缓存不一致（比如并发写入、原子性） - 仅建议作为过渡手段，上线前仍需逐步清理掉对
S的依赖
真正关键的不是语法替换，而是确认所有缓存 key 的生命周期、是否跨请求共享、有没有被其他系统（如 CLI 脚本、队列任务）访问——这些在驱动切换后都可能暴露出来。
