一、功能概述

内容静态生成（chtml） 插件 「分离部署静态文件」 。

管理员可在后台一键开启，并为每个站点单独指定静态 HTML 的生成目录；

开启后，栏目页、内容页、首页等静态文件的写入路径统一走自定义目录，不再与 CMS 程序的 Web 根目录绑定。

配置入口：内容静态生成 → 插件配置 → 分离部署静态文件。

二、功能说明

1. 分离部署关

关闭（默认）：行为与改造前一致，静态文件生成在系统 Web 目录（WEBPATH）下。

开启：按下方「按站点生成目录」设置，将静态文件输出到独立目录，适用于静态站点与动态程序分机、分目录部署。

2. 按站点设置生成目录

开启分离部署后，以表格形式展示全部站点，可为每个站点填写独立的静态文件生成目录：

路径格式：支持绝对路径（如 /data/www/static/），也支持相对网站根目录的路径。

3. 保存时目录校验

开启分离部署并保存时，对每个站点的目录依次校验：

任一站点校验失败则整单保存失败，并提示具体站点与原因，避免配置无效目录后生成阶段才报错。

4. 静态生成路径统一调度

开启分离部署且站点已配置目录后，通过插件 get_webpath() 统一解析生成路径，覆盖：

栏目静态页生成

内容静态页生成

模块 / 全站首页静态生成

内容删除、定时清理等静态文件维护

分离部署模式下，子目录不再写入 PHP 跳转用的 index.php，输出为纯静态文件，便于独立 Web 服务器或 CDN 托管

未安装 chtml 插件时，相关逻辑仍回落到 WEBPATH，不影响未使用该插件的环境。

三、典型使用场景

适用于：

前台纯静态、后台动态管理的架构

静态资源部署到 CDN 或对象存储同步目录

多站点各自输出到不同物理目录

降低 Web 目录暴露面，静态与程序目录隔离

不适用于：

动态交互的站点

互动浏览量统计的站点

实时搜索内容的站点

四、功能优点与好处

1. 架构更清晰：动静态分离

CMS 程序目录只负责后台与动态逻辑；对外访问的 HTML 集中在独立目录，职责边界清楚，符合常见生产部署方式。

2. 安全更好

静态目录可不部署 PHP，减少被利用风险

分离部署模式下不再在子目录注入 index.php 跳转文件，输出更接近纯静态站点

程序目录与对外 HTML 目录分离，缩小攻击面

3. 性能与扩展更灵活

静态站点可用 Nginx 等直接托管，无需经过 PHP

独立目录便于对接 CDN、OSS、rsync 同步

静态流量与动态请求分离，便于分别扩容与优化

4. 多站点管理更方便

每个站点可配置独立生成目录，多语言站、多品牌站、主站与子站可各用各的物理路径，互不干扰。

5. 配置可靠、运维成本低

保存即校验目录可用性与可写性，问题前置到配置阶段

开关关闭即恢复原有 Web 目录行为，可随时回退

配置集中在 chtml 插件，备份与迁移简单

6. 与现有能力无缝衔接

保留原有「一键生成栏目 / 内容 / 首页」等操作

未开启分离部署时行为不变，对现有站点零影响

与多站点、PC/移动端静态生成等能力兼容

五、使用建议

先开启分离部署，再为每个站点填写生成目录并保存，确认校验通过。

目录权限：运行 PHP 的用户需对该目录有读写权限；若由 Nginx 单独托管，需协调双方用户或组权限。

资源引用：分离部署时，模板中 CSS/JS/图片等建议使用绝对 URL 或独立静态资源域名，避免仍指向 CMS Web 目录。

同步与发布：生成完成后，可通过 rsync、CI/CD 或 CDN 刷新，将独立目录同步到对外 Web 服务器。

关闭功能：若需恢复传统模式，关闭「分离部署静态文件」并保存即可，后续生成仍写入 WEBPATH。

六、总结

分离部署静态目录 在保留 chtml 原有静态生成能力的基础上，增加了按站点自定义输出路径、保存时目录校验、全链路路径统一调度等能力，

使迅睿 CMS 从「在 Web 目录内生成静态页」升级为「可面向生产环境的动静态分离部署方案」，更适合对安全、性能、多站点和运维有更高要求的项目。