核心答案
PHPCMS V9 的模板缓存文件默认存放在以下目录:

(图片来源网络,侵删)
/caches/caches_template/
这是一个相对于网站根目录的路径。
详细说明
目录结构解析
让我们深入看一下这个目录内部的结构,这有助于你更好地理解其工作原理。
当你访问一个使用了模板的页面时(一个文章列表页 category.php),PHPCMS 会执行以下步骤:
- 读取模板文件:它会从
phpcms/templates/目录下找到对应的模板文件,default/content/category.html。 - 编译模板:PHP 解释器会将这个
.html模板文件编译成纯 PHP 代码,编译后的文件通常以.php为后缀。 - 生成缓存:这个编译后的 PHP 文件会被保存到
/caches/caches_template/目录中,以便下次直接调用,而无需再次编译,从而提高网站性能。
目录内部示例结构:

(图片来源网络,侵删)
/caches/caches_template/
├── content/
│ ├── category_1.php // 对应 ID=1 的栏目页缓存
│ ├── category_2.php // 对应 ID=2 的栏目页缓存
│ ├── index.php // 首页缓存
│ └── show_123.php // 对应 ID=123 的文章内容页缓存
├── index.php // 首页缓存(有时根目录下也会有)
└── ... (其他模块的缓存目录)
关键点:
- 按模块分类:缓存文件通常会按照模块名(如
content,search等)进行分类存放。 - 文件名与内容关联:文件名通常会清晰地标识出它所对应的页面。
index.php-> 网站首页category_1.php-> ID 为 1 的栏目页show_123.php-> ID 为 123 的文章详情页page_1_category_1.php-> ID 为 1 的栏目第 1 页的缓存
为什么使用模板缓存?
这是 PHPCMS V9 以及其他大多数 PHP 框架/CMS 的核心性能优化手段。
- 提升性能:将模板文件(HTML + 模板标签)编译成 PHP 代码后,服务器可以直接执行这些 PHP 代码,而无需每次都去解析和编译模板标签,大大减少了服务器的 CPU 和 I/O 开销。
- 减少延迟:用户再次访问同一个页面时,可以直接从缓存中读取并渲染,响应速度更快,用户体验更好。
如何管理模板缓存?
了解目录位置后,你可能需要手动管理这些缓存文件。
A. 后台一键清理(推荐)
这是最常用、最安全的方法。

(图片来源网络,侵删)
- 登录你的 PHPCMS V9 后台。
- 在顶部菜单栏找到 “系统” -> “缓存管理”。
- 在缓存管理页面,你可以看到各种缓存选项。
- 找到 “模板缓存” 或 “更新模板缓存”,点击旁边的 “更新” 按钮。
- 系统会自动清空
/caches/caches_template/目录下的所有缓存文件,并在下次访问时重新生成。
什么时候需要更新缓存?
- 修改了模板文件:当你修改了任何
.html模板文件后,必须更新缓存,否则你的修改不会在网站上显示。 - 修改了配置文件:例如修改了
phpcms/config.php等核心配置。 - 网站出现莫名的错误或显示异常:有时缓存文件损坏可能导致问题,清理缓存可以解决。
- 更换了主题或模板。
B. 手动删除(不推荐,但有效)
你可以通过 FTP 或文件管理器直接登录服务器,删除 /caches/caches_template/ 目录下的所有文件。
警告:
- 请勿删除
caches目录本身,因为里面还存放着其他重要的缓存,如数据缓存、路由缓存等。 - 手动删除后,网站在下次访问时会自动重新生成缓存文件,可能会导致首页或热门页面首次加载稍慢。
C. 修改缓存目录(高级用户)
出于安全或服务器目录结构的考虑,你可能想修改默认的缓存目录。
-
打开 PHPCMS V9 的配置文件:
phpcms/config.php。 -
在文件中找到
$config['cache']['template_root']这一项。 -
修改它的值为你想要的路径。
// 修改前 $config['cache']['template_root'] = PHPCMS_PATH.'caches'.DIRECTORY_SEPARATOR.'caches_template'.DIRECTORY_SEPARATOR; // 修改后 (放到网站根目录下的 temp 文件夹) $config['cache']['template_root'] = '../temp/caches_template/';
-
保存文件。确保你设置的新目录存在并且有正确的写入权限(通常是 755 或 777)。
| 项目 | 说明 |
|---|---|
| 默认路径 | /caches/caches_template/ |
| 作用 | 存放编译后的 PHP 模板文件,用于加速页面加载。 |
| 文件名 | 通常与页面类型(首页、栏目、内容)和 ID 相关。 |
| 如何更新 | 推荐:后台 “系统” -> “缓存管理” -> “更新模板缓存”。 |
| 手动操作 | 通过 FTP 删除该目录下的所有 .php 文件。 |
| 修改路径 | 编辑 phpcms/config.php 文件中的 $config['cache']['template_root'] 配置项。 |
希望这份详细的解答能帮助你完全理解 PHPCMS V9 的模板缓存机制!
