## 文档概述 「Sitemap生成」是 MuuCmf T6 后台管理系统中用于自动生成网站站点地图(`sitemap.xml`)的功能模块。 Sitemap(站点地图)以 XML 文件形式汇总网站所有可公开访问的页面链接,提交给百度、搜狗等搜索引擎后,可帮助搜索引擎爬虫更快、更完整地抓取站点页面,提升页面被收录的概率与 SEO 效果。 本模块由系统自动汇总「框架核心页面 + 已安装应用页面」生成站点地图,支持**定时自动生成**与**手动重新生成**两种方式;生成结果落盘到项目 `public` 目录,Web 服务器可直接通过浏览器访问。 **核心用途:** - **自动汇总站点链接**:框架核心页面与已安装应用的公开页面自动纳入站点地图,无需手工逐条添加; - **定时自动更新**:内置计划任务每日定时生成,站点地图保持最新; - **手动即时更新**:内容大量新增或修改后,可一键重新生成; - **提供提交入口**:生成后可直接复制访问地址,提交到各搜索引擎站长平台; - **查看收录范围与状态**:展示文件状态、大小、最近更新时间、robots.txt 同步状态,以及各应用是否已提供站点地图链接。 > **前置依赖**:站点域名需先在「系统配置 - 站点域名(WEB_SITE_URL)」中配置正确;若域名未配置,在定时任务等命令行场景下会生成失败。 --- ## 1. 功能说明 「Sitemap生成」用于维护站点地图文件的生成与查看,具体规则如下: 1. **自动汇总规则**:Sitemap 由「框架核心页面 + 已安装应用页面」自动汇总生成,无需手工录入链接; 2. **定时任务**:计划任务「Sitemap自动生成」每日 03:30 自动执行,日常无需人工操作; 3. **应用适配规则**:已安装应用若实现了 `app/{模块}/service/Sitemap.php` 中的 `urls()` 方法,其公开页面会被自动收录;未实现该方法的应用,只贡献框架核心页面; 4. **文件存放**:生成结果落盘到 `public` 目录,Web 服务器可直接访问 `sitemap.xml`; 5. **域名来源**:站点域名取自「系统配置 - 站点域名(WEB_SITE_URL)」,生成的链接基于该域名拼接; 6. **robots.txt 状态**:页面展示当前 `robots.txt` 是否已同步站点地图地址,供判断搜索引擎是否可通过 robots 文件发现 Sitemap。 ## 2. 功能入口 左侧导航:**渠道 → PC管理 → Sitemap生成** 进入方式:点击顶部「渠道」菜单 → 左侧「PC管理」展开 → 选择「Sitemap生成」子项,右侧主区域即显示站点地图管理页面。 ## 3. 页面组成 页面自上而下分为操作按钮区、说明提示区、基础信息区、框架核心页面区、已安装应用区五部分: | 区域 | 内容 | | --- | --- | | 操作按钮区 | 「重新生成 Sitemap」「刷新状态」按钮 | | 说明提示区 | 生成规则、定时任务、应用适配方式、域名依赖等提示文字 | | 基础信息区 | 站点域名、访问地址、文件状态、文件大小、最近更新、robots.txt 同步状态 | | 框架核心页面区 | 展示框架自带的可收录页面链接及数量 | | 已安装应用区 | 列表展示应用标识、Sitemap 提供者状态、收录说明 | ## 4. 配置项说明 ### 4.1 基础信息字段 | 字段 | 说明 | | --- | --- | | 站点域名 | 读取「系统配置 - 站点域名(WEB_SITE_URL)」,生成的 Sitemap 链接基于该域名拼接;域名错误或为空会导致生成失败 | | 访问地址 | `sitemap.xml` 的在线访问链接,可直接复制后提交给搜索引擎站长平台 | | 文件状态 | 当前 Sitemap 文件是否存在,如「已生成」「未生成」 | | 文件大小 | 当前 `sitemap.xml` 文件体积(如 1.6 KB) | | 最近更新 | 上一次生成 Sitemap 的时间 | | robots.txt | 站点地图地址是否已同步到 `robots.txt`,如「已同步」「未同步」 | ### 4.2 框架核心页面 | 字段 | 说明 | | --- | --- | | 页面链接 | 框架自带的公开页面路径,如首页 `/`;标题旁标注页面条数 | ### 4.3 已安装应用列表 | 字段 | 说明 | | --- | --- | | 应用标识 | 应用模块名称(如 activity、articles、ask、business),标题旁标注应用总数(如 21 个) | | Sitemap 提供者 | 状态标签:「已提供」表示该应用已实现 `urls()` 方法,页面链接会被自动收录 | | 说明 | 备注文字,如「已实现 urls(),页面会被自动收录」 | ### 4.4 操作按钮说明 | 按钮 | 用途说明 | | --- | --- | | 重新生成 Sitemap | 手动触发站点地图文件重新生成,即时刷新 Sitemap 内容 | | 刷新状态 | 刷新页面上的文件状态、大小、更新时间、同步状态等信息 | ## 5. 操作方法 ### 5.1 前置配置(必须先完成) 1. 进入「系统 → 系统配置」,找到站点域名(WEB_SITE_URL); 2. 填写完整的网站域名(示例:`https://www.muucmf.cc`),保存配置; 3. 域名必须是外网可访问的 HTTPS 域名;内网地址、空域名会导致生成失败。 ### 5.2 手动生成 Sitemap 1. 进入「渠道 → PC管理 → Sitemap生成」页面; 2. 点击左上角「重新生成 Sitemap」按钮; 3. 等待执行完成,点击「刷新状态」; 4. 查看「文件状态」变为「已生成」,记录「最近更新」时间; 5. 复制「访问地址」,即可提交到搜索引擎站长平台。 ### 5.3 查看收录页面范围 1. 在「框架核心页面」区查看框架自带的收录链接; 2. 在「已安装应用」列表中,标记为「已提供」的应用,代表其页面会自动加入 Sitemap;未标记「已提供」的应用不会自动收录应用内页面; 3. 若某应用需要纳入 Sitemap,需由开发人员在对应应用目录下补充 `app/{模块}/service/Sitemap.php` 并实现 `urls()` 方法。 ### 5.4 查看 robots.txt 同步状态 1. 生成成功后,查看「robots.txt」状态:已同步表示站点地图地址已写入 `robots.txt`,搜索引擎读取 robots 文件时可自动发现 Sitemap;未同步则表示尚未写入; 2. 如状态显示未同步且需要补充,请在站点 `robots.txt` 中加入 Sitemap 地址后再刷新本页面状态。 ### 5.5 查看与调整自动定时任务 1. 自动任务默认每日 03:30 自动生成,无需人工干预; 2. 如需修改执行周期或时间,进入「系统 → 计划任务」,找到 `Sitemap自动生成` 任务进行调整。 ### 5.6 提交到搜索引擎 1. 复制页面上的「访问地址」(如 `https://你的域名/sitemap.xml`); 2. 分别进入百度资源平台、搜狗站长平台等站长后台; 3. 在站点地图提交入口粘贴该链接并提交,加速爬虫抓取与收录。 ## 6. 使用建议 1. 网站页面、文章、商品大量新增或修改后,建议手动点击「重新生成 Sitemap」,及时更新站点地图; 2. 站点域名修改后,**必须重新生成 Sitemap**,否则文件内链接的域名会保持旧值; 3. 若 Sitemap 一直生成失败,优先排查:站点域名是否已配置、服务器是否具备 `public` 目录写入权限、计划任务服务是否正常; 4. 无需频繁手动生成,一般每日由定时任务更新一次即可;日常无需重复点击; 5. 未适配 `urls()` 方法的应用不会自动收录其页面,需要开发适配后才会纳入站点地图; 6. Sitemap 仅用于辅助 SEO 收录,是否被搜索引擎收录、排名如何,最终由搜索引擎规则决定。 --- ## 附录:常见问题排查 | 问题现象 | 排查方向 | | --- | --- | | 点击重新生成后文件状态不变、提示生成失败 | ① 站点域名为空或格式错误;② 服务器对 `public` 目录无写入权限;③ 定时任务/命令行服务异常 | | 某个应用页面没有出现在 Sitemap 中 | 该应用的 Sitemap 提供者不是「已提供」,需开发适配 `urls()` 方法 | | robots.txt 一直显示未同步 | 检查站点 `robots.txt` 是否可写入、是否已加入 Sitemap 地址 | | 访问地址打开 404 | 确认站点域名配置正确、文件已生成且 `public` 目录可被 Web 服务器访问 | 按以上步骤操作,即可完成 MuuCmf T6 后台「Sitemap生成」的查看、生成与提交。