目录结构
每个目录负责什么,哪些能改、哪些别动、哪些必须放在网站根目录外。
整体布局
站点目录/ ← 整个程序包放这里
├── 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 的访问范围已经包含上级目录,不需要为了「能不能读到」而把文件挪进网站目录。
