ThinkPHP静态缓存用法详解

基本配置要求

要使用静态缓存，首先需要在项目配置文件（如 Conf/config.php）中开启相关选项，并设定缓存保存的路径与有效期。

'HTML_CACHE_ON'     => TRUE   // 开启静态缓存
'HTML_PATH'         => './html' // 静态文件保存根目录，建议使用相对或绝对路径
'HTML_CACHE_TIME'   => 60      // 默认缓存有效期（秒），-1 表示永久缓存
'HTML_READ_TYPE'    => 0       // 读取类型：0为重写URL直接显示HTML；1为重定向跳转

• 开启状态：HTML_CACHE_ON 设为 true 方可生效。
• 存储路径：HTML_PATH 指定生成的 .html 文件存放位置，确保该目录具有读写权限。
• 读取模式：HTML_READ_TYPE 设置为 0 时，浏览器看到的是当前动态 URL 但内容是静态文件；设置为 1 时，浏览器 URL 会变为实际的 html 文件地址。

核心原理分析

ThinkPHP 的静态缓存并非简单的“快照”，而是在特定条件触发下进行的完整渲染。当请求满足缓存命中条件时，框架会将完整的 DOM 树输出并重定向至本地文件系统保存。后续相同条件的请求将直接读取文件系统的文本内容并返回，完全绕过模型层（Model）和控制器核心逻辑。

编写缓存规则

仅在配置中开启是不够的，必须创建专门的规则文件来定义哪些操作需要被缓存。在项目的配置目录下（通常是 Conf 目录）新建 htmls.php 文件。

第1步：建立规则入口文件

在 Conf/htmls.php 中定义返回数组，格式如下：

<?php
return array(
    '模块名:操作方法' => array('静态文件名', '缓存时间', '命名规则'),
    // ... 更多规则
);
?>

第2步：设置具体规则参数

每个键值对对应一个控制器的操作方法，数组包含三个必填项：

1. 模块及操作标识：可以是单一操作名（应用于所有模块）、Module:Action（精确到某模块某方法）或 *（匹配所有，需谨慎使用）。
2. HTML文件名模板：定义生成的静态文件名称。可以使用以下变量：
   • {:module}：当前模块名
   • {:action}：当前方法名
   • {$_GET['id']}：获取 URL 中的 GET 参数
   • {:session('user')}：Session 内容等
3. 命名处理规则：可选填。用于生成文件名后的二次处理函数，例如 md5，常用于处理长参数以避免文件名过长或非法字符。

第3步：实例演示

假设要对 Article 模块下的 detail 方法进行缓存：

return array(
    'Article:detail' => array('{:module}/{:action}_{id}.html', 3600),
);

此处生成的文件名为 article/detail_1.html，保存在 ./html/ 目录下，有效期为 3600 秒。如果 ID 参数导致路径中包含 /，系统会自动创建对应的子文件夹。

注意事项与局限性

• 适用场景：该方案最适合内容极少变动、高并发读写的列表页或详情页。对于高度个性化或实时性强的页面，频繁失效会导致回源压力过大。
• 兼容性警告：ThinkPHP 的这套原生静态化机制主要存在于早期版本（如 THP3.2）。在较新的 ThinkPHP 版本（TP5/TP6/TP8）中，官方更倾向于使用外部缓存引擎或中间件来实现高性能页面构建。
• 安全风险：如果直接使用 {$_GET['name']} 且未经过滤，可能引发文件名注入或跨站脚本风险，建议配合 md5() 等哈希规则处理不可控参数。