如果你正在考虑用WonderCMS做企业站或个人博客，先别急着装，听我把这几年的血泪史说完，这个CMS确实轻量到离谱——一个压缩包不到2MB，不用数据库，PHP环境就能跑，但正因为“太简单”，很多人栽在细节上，我一开始就是被“零数据库”吸引,结果差点被坑到崩溃。
第一个坑：伪静态规则搞不定，网址长得像车祸现场
WonderCMS默认的URL是?page=home这种查询参数形式，虽然能用，但丑且不利于SEO，我第一版网站上线后，谷歌收录了半个月都没动静，检查才发现动态URL全被搜索引擎忽略了，网上搜解决方案，大部分教程只给了Apache的.htaccess规则，可我用的是Nginx服务器,直接照搬导致404刷屏。
用WonderCMS建站三年，我踩过的坑和最终留下的配置
解决方案：如果你用Nginx，千万别用Apache的规则,在你的server块里加这段：
location / {
try_files $uri $uri/ /index.php?$args;
}
然后去后台设置里把“友好URL”打开，刷新缓存就干净了，如果是Apache，默认.htaccess其实已经写好了，但记得确认AllowOverride All开了,否则规则不生效。
第二个坑：主题更新把自定义代码全冲没了
WonderCMS的主题机制很“原始”——你直接在themes/目录里改模板文件，没有子主题概念，我为了给首页加一个跑马灯，直接改了default.php，结果官方一更新主题，我的代码全没了,还报了一堆PHP警告。
解决方案：别碰官方主题文件！把所有自定义功能写成插件，WonderCMS的插件机制其实不复杂，在plugins/下建一个文件夹，里面放一个PHP文件，用addAction和addFilter挂载逻辑，比如我的跑马灯，写了个插件调用addEvent('pageLoaded', 'myMarquee')，模板里只留一个<div id="marquee"></div>,更新主题再也不怕。
第三个坑：备份恢复后，图片引用全部断裂
因为不用数据库，WonderCMS把内容和文件路径都写在site/content里，我用备份插件导出后，换了个域名恢复，结果所有图片还是指向旧域名，页面直接白屏，折腾半天才发现，它存储的是绝对路径,不是相对路径。
解决方案：恢复前先编辑site/content/data.json，全局替换旧域名为新域名，但注意别用编辑器直接替换，容易破坏编码，用命令行sed -i 's/old.com/new.com/g' data.json最稳妥，图片资源尽量用相对路径引用——在富文本里，地址栏只填uploads/xxx.jpg，别带https://域名/前缀,这样换域名都不用改。
推荐配置：别贪多，这几个插件就够了
WonderCMS官网插件库看着不少，但很多半年没更新，我踩了一圈坑,最后稳定运行的只有这几个：
- WonderCMS Admin Utility（后台工具）：批量清理无效文件、查看PHP错误日志,排查白屏就靠它。
- SEO插件：自动生成sitemap，还能给每个页面独立设关键词，自带
meta标签管理。 - Simple Contact Form：不用数据库的留言表单，提交结果发邮件，防垃圾功能够用，别装那些带验证码的,依赖第三方服务容易挂。
- Password Protect：做临时页面时用，比服务器basic auth方便,但记住别用默认密钥。
千万别装：任何“会员系统”“商城插件”——这些是PHP重度用户的需求，WonderCMS的轻量定位根本扛不住,真要商城老老实实用WooCommerce。
长期维护的4条血泪建议
- 每月手动删一次
sessions/目录：这个目录放临时会话文件，不清理会越积越多，导致后台卡顿，官方不提供自动清理，写个cron命令：find /path/to/sessions -type f -mtime +7 -delete。 - PHP版本别追新：我曾在PHP 8.3上跑得飞快，结果一个老插件直接报
Deprecated错误，整个后台变白屏，用8.1或8.2最稳，同时把error_reporting(E_ALL & ~E_DEPRECATED)加到index.php顶部,能屏蔽大部分兼容性警告。 - 主题自定义永远用插件+CSS文件覆盖：在主题的
style.css末尾追加你的样式，别改原文件，如果觉得文件太长，用@import引入一个custom.css,更新主题只改一行。 - 每月导出一份JSON文件：后台的“备份”按钮只打包了文件，但包含
data.json的完整备份才能一键恢复，我用一个简单的shell脚本，每周把site/目录打包，加个时间戳，传到对象存储,防的是服务器炸了全没。
最后说句大实话：WonderCMS不适合复杂项目，但对预算有限、内容更新不频繁的展示型网站，它能帮你在一个晚上上线，而且维护成本极低，记住我上面这些教训，别去重蹈覆辙，你就已经省下至少2000块的开发费和十几个小时的折腾时间，建站这事,省心就是省钱。
发表评论