ThinkPHP 6.1 静态缓存怎么设置才能缓存移动端页面？-ThinkPHP-PHP中文网

tp6.1 不支持内置移动端页面静态缓存；需自行识别设备类型（如 ismobile()）并手动将渲染后的 html 写入 public/static/m/ 目录，再通过中间件拦截请求直接返回静态文件。

thinkphp 6.1 静态缓存怎么设置才能缓存移动端页面？

ThinkPHP 6.1 本身不提供原生的“移动端页面静态缓存”功能。你提到的“静态缓存”，在 TP6.1 中通常指两种不同机制：

请求缓存（Request Cache）：TP5.0 引入、TP6.x 已移除的功能（官方明确废弃，不再支持 ->cache() 路由级静态 HTML 缓存）；
模板缓存 / 视图缓存：TP6 默认开启，但仅缓存编译后的 PHP 模板字节码（.php 文件），不是页面 HTML 内容，也不区分 PC/移动端。

所以，直接问“TP6.1 静态缓存怎么设才能缓存移动端页面”，答案很明确：
✅ TP6.1 没有内置的、按设备类型自动分离并缓存 HTML 文件的静态缓存能力。
❌ 不能像 TP5 那样用 Route::get('m/news/:id')->cache(...) 一键生成 /runtime/cache/m_news_123.html。

但你可以自己实现移动端页面的静态缓存，关键是两点：
① 识别并区分移动端请求；
② 把渲染结果写成独立 HTML 文件，并按设备类型分目录存储。

一、先准确识别移动端访问

不要依赖 UA 简单关键词（如 mobile），要用更可靠的判断逻辑：

推荐使用 ThinkPHP 内置助手函数 isMobile()（需自行补充或封装）：

// app/helper.php 或某服务类中定义
function isMobile(): bool
{
  $ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
  return preg_match('/(Android|iPhone|iPod|iPad|BlackBerry|IEMobile|Opera Mini)/i', $ua) > 0;
}

或在控制器中统一判断并设置标识：

$device = isMobile() ? 'mobile' : 'pc';
View::assign('device', $device);

二、手动实现“移动端静态 HTML 缓存”

核心思路：在页面渲染完成后，将输出内容保存为 public/static/m/xxx.html，下次请求直接 readfile() 返回，跳过框架执行。

btpanel phpsite 宝塔面板PHP网站

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

下载

步骤如下：

在对应控制器方法末尾，检查是否启用移动端缓存且缓存未过期
生成唯一缓存路径，例如：public/static/m/news_{$id}.html（务必含 device 标识）
调用 view()->fetch() 获取渲染后 HTML 字符串（非 echo）
用 file_put_contents() 写入静态文件，设置合理过期时间（如 3600 秒）
在中间件或路由前置中拦截匹配的移动端 URL，若静态文件存在且未过期，直接 readfile() 并 exit

示例中间件（app/middleware/MobileStaticCache.php）：

```php class MobileStaticCache { public function handle($request, \Closure $next) { if (isMobile() && $request->isGet()) { $path = ltrim($request->url(), '/'); $key = md5('m_' . $path); $file = public_path() . '/static/m/' . $key . '.html';

        if (is_file($file) && time() - filemtime($file) <p>}</p><pre class="brush:php;toolbar:false;">
<p>控制器中写缓存（以新闻详情为例）：</p>
```php
public function read($id)
{
    $html = view('news/read', ['id' => $id])->fetch();

    if (isMobile()) {
        $key  = md5('m_news_' . $id);
        $file = public_path() . '/static/m/' . $key . '.html';
        @mkdir(dirname($file), 0755, true);
        file_put_contents($file, $html);
    }

    return $html;
}

三、关键注意事项

不要缓存带用户态的内容：登录信息、购物车数量、CSRF token 等必须通过 AJAX 单独加载，静态页里留占位符（如 <div id="cart-count"></div>）
缓存路径必须隔离 PC 和 mobile：共用一个目录会导致手机访问到 PC 版本，或反之
清除缓存要同步操作：文章更新时，不仅要删 public/static/m/news_123.html，也要删 PC 版（如 public/static/pc/news_123.html）
CDN 友好：这种静态文件天然适配 CDN，可配置缓存策略（Cache-Control: public, max-age=3600）