v1.12.0:常见问题模块、RSS 订阅与后台写操作收口

发布时间:2026-11-12 浏览:25 栏目:卫民CMS

2026 年 11 月 11 日,卫民CMS 演示站交付 v1.12.0。这一版做了三件事:把散落在模板里的问答内容收进数据表,让后台能自己维护;给站点加一个标准的 RSS 订阅出口;把后台所有会改数据的链接式操作统一收口为 POST 提交。另外补上了站点目录的每日自动备份。前台视觉、主 CSS 与 Logo 照旧不动。

为什么先做「内容结构化」而不是继续加页面

产品页上的常见问题原本是控制器里写死的数组,改一句话要发一次代码。客户实际使用中这类内容变动最频繁,写成死数据等于把维护成本留给自己。这一版新增 wm_faq 表(site_id / product_id / question / answer / sort / status / delete_time),后台可以按产品维护问答、调顺序、软删除,前台新增 /faq.html 按产品分组展示,并输出 FAQPage 结构化数据。

这里有个必须守住的取舍:FAQ 页复用了已有的 page/index.html 模板,不新增模板文件,样式写在内容块内的 <style> 里。原因是主题机制要求默认主题与现有模板逐字节一致,多一个模板文件,之后每次升级都要同步两份。少一个文件,升级风险就少一处。

坑一:只把路由改成 POST 并不管用

后台的删除、恢复、彻底删除、启停原本都是 <a href> 链接,浏览器预取、图片标签、聊天软件预览都可能帮你「点」一下。第一反应是把 route/app.php 里的 21 条写路由从 Route::get 改成 Route::post 并挂 csrf 中间件 —— 但这不够。

ThinkPHP 的路由是旁路:路由没命中时会回落到默认调度,直接按 PATH_INFO 第一段当控制器、第二段当方法执行。GET /admin.php/news/del/5 照样能跑到 del(),路由表形同虚设。所以真正的闸门必须放在控制器基类:Base::initialize() 里比对当前 action 是否属于写操作白名单(del / restore / purge / status),是则直接拦下并回列表页。

拦截时必须用 throw new HttpResponseException(redirect(...)),不能只写 return。在 initialize() 里 return 只是结束了初始化方法本身,动作方法照样会执行 —— 这一点在 v1.10 做演示账号只读保护时已经踩过一次。

另一个细节:initialize() 阶段 Request::action() 未必已经赋值,只靠它判定会漏。所以同时从 pathinfo() 第二段推一遍方法名,两个口径任一命中就拦。回退地址用控制器名到列表页的白名单映射,不用 Referer,避免开放重定向。

坑二:改了数据源却忘了改读取方,就是假功能

FAQ 建表、后台能增删改,看起来功能就完成了。但产品详情页原来的问答读取的是控制器里的硬编码数组,后台改完前台一点变化都没有 —— 这种「后台能改、前台不变」的功能在验收时最容易被当成已交付。所以这一版把产品页的问答也切到 wm_faq,并保留一层兜底:表还没建(升级窗口)或某产品暂无数据时,回退到原有硬编码内容,保证产品页永远不会出现空白区块。

验收也据此设计:后台改一条问题,立刻用真域名请求 /faq.html,看是否实时同步。同步说明两件事同时成立 —— 数据源统一,且静态缓存失效正确。验完再改回去,不留测试痕迹。

坑三:RSS 的 Content-Type 会被补两遍 charset

新增 /rss.xml 输出 RSS 2.0,最近 20 篇。第一版写 contentType('application/rss+xml; charset=utf-8'),实际响应头变成 application/rss+xml; charset=utf-8; charset=utf-8 —— ThinkPHP 8 会自己补 charset,手动带上就重复了。改成只给 application/rss+xml 即可。顺手把 /sitemap.xml 的同一处写法也修了。

RSS 必须实时,不能命中整页静态缓存,所以 rss.xml 加进 config/static_cache.php 的排除名单,并显式回 X-Static-Cache: SKIP。排除项必须显式回 SKIP,否则「按设计排除」和「中间件没加载」的响应完全一样,出问题时无法区分。XML 里所有文本走 ENT_XML1 转义,否则标题里的单引号和 & 会破坏文档结构;验收时用 DOMDocument 解析一遍,不靠浏览器宽容解析蒙混过关。

坑四:建表必须早于源码上传

部署顺序错一步就是 500。后台 FAQ 控制器一上线就会查 wm_faq,表不存在直接抛异常,后台菜单点进去就是错误页。所以顺序固定为:线上现读断言 → 时间戳备份 → 建表 → 跑种子(导入原有 17 条问答)→ 校验数据非空 → 上传源码 → 远端 php -l → 清三处模板缓存 → static:clear 与 static:build → 真域名复验。种子脚本带零数据断言,条数为 0 直接退出码 1 中止,避免「表建好了但内容是空的」这种半成品上线。

另外 wm_faq 纳入角色权限(faq.view / faq.write)与侧边栏菜单,写入走模型事件触发静态缓存失效,保证后台保存后前台立刻能看到。

运维补齐:站点目录每日自动备份

此前只在每次改动前手工备份,站点目录本身没有定时备份。这一版加了每日凌晨的打包任务:排除 runtime,打完用 tar tzf 验证包可读,体积小于 1MB 视为失败并删掉半成品,保留最近若干天。/root 下历次手工备份只按 30 天自然回收,不做激进删除。同时把操作日志的清理命令挂进周日执行,默认仍是 dry-run,带 --run 才真正删除。

验收结果

前台 /、/faq.html、/rss.xml、/sitemap.xml 均 200,静态缓存分 HIT / SKIP 两类且符合设计;后台五个入口 200,问答列表 17 条,改一条后前台实时同步;GET 访问删除类地址不再改动任何数据,只回退到列表页并提示需从按钮提交。静态页生成成功 23 / 失败 0。日志中当日错误全部来自本次验收脚本自身,产品代码无报错。

改动范围

新增 wm_faq 表与回滚 SQL、幂等种子;新增 FAQ 模型、后台控制器与两个模板、两个权限点与菜单入口;新增前台 FAQ 聚合页与 RSS 输出;产品页问答改为读库并保留兜底;21 条后台写路由改为 POST + csrf,控制器基类增加写操作拦截,10 个列表模板的链接式操作改为表单提交;新增站点目录备份脚本与定时任务。前台视觉、主 CSS、Logo 均不在本批改动内。