ThinkPHP中废弃的S方法缓存如何升级_适配Cache驱动的缓存实现-ThinkPHP-PHP中文网

S函数在ThinkPHP 5.1+中被彻底移除，因其硬编码路径、无驱动抽象、不支持TTL和标签；须用Cache::get()/set()替代，并注意参数拆分、键名格式及驱动差异。

thinkphp中废弃的s方法缓存如何升级_适配cache驱动的缓存实现

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 拆成了两个方法。需按上下文区分：

单参数 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/ 完全不同，不要指望缓存能自动延续。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

如何让老代码“无感”过渡（临时兼容层）

如果项目大、调用分散，又没时间逐个改，可以在 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);
    }
}

这样保留了原签名，但底层走的是新驱动。不过要注意：