LECMS静态缓存怎么开启

照着做完，你能让 LECMS 把动态页面生成为静态 HTML，明显降低数据库压力、提高打开速度。

第一步：先确认版本，决定用哪种开启方式

LECMS 的静态缓存有两套常见入口：后台开关和配置文件。版本不同菜单名会略有差异，所以第一步先确认版本号。登录后台后看右上角或「系统信息」页的版本号；也可以直接看服务器上的文件，LECMS 根目录下通常有 version.php 或 data/config.php，用 FTP/宝塔文件管理器打开就能看到版本。

• 2.x 版本：以配置文件为主，后台开关较少。
• 3.x 及以后：后台一般有独立的性能/缓存设置页。

注意：改任何配置前，先把 data/ 和配置文件目录整个备份一份，出问题能立刻还原。

第二步：在后台开启静态缓存

进入后台，路径通常是「系统」→「系统设置」→「性能优化」（部分版本写作「缓存设置」或「SEO 设置」）。在这个页面里找这几项并逐一设置：

1. 「开启静态缓存」或「HTML 缓存」——选「开启」。
2. 「缓存有效期」——建议 3600（1 小时）；更新频繁的站设 600。
3. 「缓存目录」——保持默认，一般是 data/cache/ 或 runtime/html/。
4. 「缓存首页」「缓存列表页」「缓存内容页」——按需勾选，内容页和列表页必勾。

保存后清一次缓存，页面顶部一般会提示「设置成功」。

注意：如果这个页面没有静态缓存相关选项，说明你的版本用的是配置文件方式，直接看第三步。

第三步：改配置文件（后台没开关时用）

打开 LECMS 根目录下的 config/ 目录，找到 config.php 或 cache.php。用编辑器搜索 cache 关键字，通常能看到类似结构：

'cache' => [
    'type'   => 'File',
    'path'   => './data/cache/',
    'expire' => 3600,
    'html'   => false,
],

把 'html' => false 改成 'html' => true（有的版本字段名是 static_cache 或 html_cache），expire 按需要改。保存后上传覆盖原文件。

第四步：把缓存目录权限设成可写

这一步不做，前面全是白搭——程序写不进缓存文件就会静默失败。如果你用宝塔面板，进入「文件」，定位到 data/cache（或 runtime/html），右键→「权限」，所有者设为运行 PHP 的用户（常见是 www），权限设为 755，勾选「应用到子目录」。

命令行方式：

chown -R www:www /www/wwwroot/你的站点/data/cache
chmod -R 755 /www/wwwroot/你的站点/data/cache

注意：不要图省事给 777，容易被上传木马利用。

第五步：配置伪静态规则

静态缓存生效后，URL 需要走伪静态才能正常访问。宝塔面板进入「网站」→ 点你的站点 →「设置」→「伪静态」，在输入框里粘贴 LECMS 官方提供的规则（官网帮助文档里有对应 Nginx/Apache 版本），保存后点「重载配置」。Nginx 用户手动配置的话，规则文件在 /www/server/panel/vhost/rewrite/你的域名.conf。

第六步：验证缓存是否真的生效

访问几个内容页，然后去 data/cache/ 目录看有没有生成新的 .html 或 .php 缓存文件，有就说明成功了。也可以在浏览器按 F12 打开开发者工具，看响应头里是否出现 X-Cache: HIT 之类的标记。

如果没生成文件，按顺序排查：目录权限是否可写、配置文件是否保存成功、是否有 CDN 或 Nginx 层面的缓存拦截、PHP 是否装了 fileinfo 扩展。

小结

• 先看版本号，确定走后台开关还是配置文件。
• 后台路径：系统 → 系统设置 → 性能优化。
• 配置文件改 html/static_cache 字段为 true。
• 缓存目录权限 755、属主为 PHP 运行用户，不要 777。
• 伪静态规则必须配置，否则缓存页面打不开。
• 改完清缓存再访问，去缓存目录确认文件真的生成了。