首页 / 开发手册 / 目录结构

目录结构

每个目录负责什么,哪些能改、哪些别动、哪些必须放在网站根目录外。

整体布局

站点目录/              ← 整个程序包放这里
├── wwwroot/           ← 对外网站根目录(把域名的根目录指向它)
│   ├── index.php      唯一入口
│   ├── install.php    安装程序(装完删除)
│   ├── static/        CSS / JS / 图标
│   └── uploads/       上传的图片与附件
├── core/              内核:路由、模板引擎、数据层、权限、授权
├── app/               控制器:各个页面的请求处理
├── templates/         模板主题
│   ├── default/       正式站主题
│   ├── demo/          演示站主题
│   └── admin/         站点管理界面的主题
├── config/            config.php(含密钥,勿外泄)
├── data/              数据库文件、备份、更新包
├── storage/           模板编译缓存、上传的源文件
└── docs/              开发手册的种子文件

网站根目录指向哪

对外访问的是 wwwroot/,所以要把域名的网站根目录指到它。指好之后:

  • 访客看到的网址是 https://你的域名/,不会出现 wwwroot,跟把文件直接摊在根目录上完全一样
  • 而 core/、config/、data/ 仍然在网站目录之外,HTTP 够不着

一句话:对外就是一个根目录,只是文件系统上内核没有和网站目录混在一起。

⚠️ 有些空间不给改网站根目录。那种情况下不要把程序平铺进对外目录当绕开 —— 那会把配置、数据库、内核一起暴露在网址下。换一个能设根目录的主机,或用支持「子目录绑定」的方案。

为什么把内核和网站根目录分开

传统做法是把所有 PHP 文件都放在网站目录下,靠 .htaccess 或 Nginx 规则去拦。这套系统不这么做,原因很直接:

  • 拦截规则写错一次就是源码泄露,而文件根本不在网站目录里则不存在拦截失败的可能
  • 不依赖任何 Web 服务器配置,换环境不用重新调规则
  • 数据库、配置、备份文件自然也都在安全区

哪些能改、哪些别手改

目录能不能改说明
templates/随便改自己写主题就放这里
wwwroot/static/随便改样式与脚本,改完刷新即可
docs/随便改开发手册的内容源
core/别手改内核。在线更新会按白名单覆盖,本地改动会被冲掉
storage/别手改模板编译缓存,删掉会自动重建,改它没有意义
data/别手改数据库与备份。要动请先备份
主题放在哪都行:模板可以放在 templates/,也可以放在站点根目录之外 —— PHP 的访问范围已经包含上级目录,不需要为了「能不能读到」而把文件挪进网站目录。
没找到答案? 可以在 联系我们 留言说明使用场景,我们会补充进文档。