首页 /功能特性

能力清单,逐条讲实现

不列虚的功能名词。下面每一条都写清楚它具体是怎么做的、 为什么这么做,以及它在什么情况下会不适用。

核心能力

这些能力怎么落地

点开任意一条可以看到完整的用法与代码示例。

技术底座

撑住这些能力的三条硬约束

功能可以逐步增加,底层结构不能将就。下面三条写在结构里,绕不过去。

模板层没有 SQL 能力

编译器只认识标签,标签只调用数据层,数据层只用占位符绑定。模板作者就算想注入也没有语法可用。

源码与数据在网站目录之外

不依赖任何服务器拦截规则。规则会写错,文件不在那个位置则不存在写错的可能。

零第三方依赖

没有 Composer 包、没有前端框架。上传即用,也不会因为某个依赖停止维护而跑不起来。

边界

哪些事我们不做

把不做的说在前面,比事后解释省事。

场景我们的态度
需要可视化拖拽建站不提供。我们走的是模板标签路线,会 HTML 就能控住每一个细节
需要开箱即用的插件市场暂未提供。目前扩展靠主题与自定义字段完成
需要多语言站群在路上。当前一个站点一套语言
需要域名绑定式授权不做。授权只校验签名,不绑域名、不回调服务器
把安全补丁做成收费项不做。补丁对所有版本一视同仁
模板引擎

一套标签,把数据取出来

模板就是普通的 HTML 文件。不必先理解 MVC,也不必读完几百页文档 —— 把标签写进 HTML,页面就能渲染出内容。

  • 11 个块标签:list、nav、detail、banners、links、tags、loop…
  • 8 个修饰符:日期格式化、摘要截断、富文本、取首字…
  • 条件与循环:if / else / loop,够覆盖企业站全部常见场景
  • 主题即文件夹:复制一份改改就是一套新站
 templates/default/list.html
<!-- 一个标签,把列表取出来 -->
{naicha:list name="news" num="10" page="{naicha:param name='page'}"}
  <a href="{list.url}">{list.title}</a>
  <!-- 默认自动转义,防 XSS -->
{/naicha:list}

<!-- 分页条,零配置 -->
{naicha:page}

<!-- 条件判断 -->
{naicha:if var="list.top" eq="1"}置顶{/naicha:if}
安全设计

从结构上限制,而不是靠补丁

多数 CMS 的安全事故来自同一处:把用户输入拼进 SQL 和模板。NaichaCMS 的做法是让这件事在语法上就做不到。

  • 模板层无 SQL 能力——编译器只认识标签,标签只调用数据层
  • 唯一 SQL 入口——core/Db.php,全部占位符绑定
  • 输出默认转义——只有显式 html="1" 才输出富文本
  • 全文 CSRF + 登录限流 + 上传白名单,生产环境不外泄堆栈
  • 数据库在 wwwroot 之外,随机命名,HTTP 访问一律 404
 core/Db.php — 唯一允许写 SQL 的地方
// 对:占位符绑定,用户输入永远进不了 SQL 结构
Db::all('SELECT * FROM contents WHERE cid=:c AND status=:s',
        ['c' => $cid, 's' => 'published']);

// 排序这类无法参数化的位置 —— 白名单映射
$order = $orderMap[$input] ?? $orderMap['sort desc'];

// 错:任何形式的拼接都不允许
Db::all("SELECT * FROM contents WHERE cid=$cid");

想先在本机试一遍?

用 NaichaEnv 把整套环境装在自己的电脑上:可以随意改、改坏了删掉重来,不影响已经上线的站。