StartMVC开发手册

可以快速上手的开发文档

手册目录

目录结构

项目根目录
├── app/ # 应用目录(PSR-4: app\)
│ ├── admin/ # 后台模块
│ │ ├── controller/ # 控制器目录
│ │ ├── model/ # 模型目录
│ │ └── view/ # 视图目录
│ ├── common/ # 公共模块(各模块共用的控制器 / 模型)
│ │ ├── controller/ # 公共控制器
│ │ └── model/ # 公共模型
│ ├── home/ # 前台模块(默认模块)
│ │ ├── controller/ # 控制器目录
│ │ ├── language/ # 多语言包
│ │ ├── model/ # 模型目录
│ │ └── view/ # 视图目录
│ └── middleware/ # 自定义中间件
├── config/ # 配置文件目录
│ ├── common.php # 系统基础配置
│ ├── database.php # 数据库连接配置
│ ├── cache.php # 缓存驱动配置
│ ├── log.php # 日志配置
│ ├── route.php # 路由配置
│ ├── middleware.php # 中间件配置
│ ├── pagination.php # 分页配置
│ └── view.php # 视图 / 模板配置
├── extend/ # 扩展类库目录(PSR-4: extend\)
├── function/ # 自定义函数目录(框架启动时自动载入)
│ ├── custom_function.php # 自定义函数
│ └── csrf.php # CSRF 助手函数
├── public/ # Web 根目录(对外唯一可访问目录)
│ ├── index.php # 入口文件
│ ├── .htaccess # Apache 重写规则
│ ├── nginx.htaccess # Nginx 重写规则
│ ├── web.config # IIS 重写规则
│ ├── static/ # 静态资源(css / js / images)
│ └── upload/ # 上传文件目录
├── runtime/ # 运行时目录(需可写)
│ ├── cache/ # 缓存文件(含路由编译缓存 routes.php)
│ ├── logs/ # 日志文件,按天生成 {日期}_{级别}.log
│ └── temp/ # 模板编译后的临时文件
├── startmvc/ # 框架核心目录(PSR-4: startmvc\)
│ ├── boot.php # 框架引导文件
│ ├── autoload.php # 自动加载
│ ├── function.php # 公共助手函数
│ └── core/ # 核心类
│ ├── App.php # 应用类(请求分发)
│ ├── Controller.php # 控制器基类
│ ├── Model.php # 模型基类
│ ├── View.php # 视图类
│ ├── Router.php # 路由类
│ ├── Request.php # 请求类
│ ├── Response.php # 响应类(唯一响应出口)
│ ├── Container.php # 容器类
│ ├── Loader.php # 自动加载 / 反射注入
│ ├── Config.php # 配置类
│ ├── Middleware.php # 中间件管理器
│ ├── Session.php # 会话类
│ ├── Cookie.php # Cookie 类
│ ├── Csrf.php # CSRF 防护
│ ├── Validator.php # 数据验证类
│ ├── Pagination.php # 分页类
│ ├── Upload.php # 上传类
│ ├── Cache.php # 缓存门面类
│ ├── Db.php # 数据库门面类
│ ├── Logger.php # 日志类
│ ├── Exception.php # 异常处理类
│ ├── HttpResponseException.php # 响应异常(承载 Response 对象)
│ ├── Event.php # 事件类
│ ├── Http.php # HTTP 辅助类
│ ├── cache/ # 缓存驱动
│ │ └── Cache.php
│ ├── console/ # 命令行内核
│ │ ├── Console.php # 命令注册 / 解析 / 分发
│ │ ├── Command.php # 命令基类
│ │ ├── Output.php # 终端输出排版
│ │ └── commands/ # 内置命令
│ ├── db/ # 数据库层
│ │ ├── DbCore.php # 数据库核心类
│ │ ├── DbCache.php # 查询缓存
│ │ └── DbInterface.php # 数据库接口
│ └── tpl/ # 系统模板
│ ├── trace.php # 调试追踪面板
│ ├── error.php # 错误输出模板
│ ├── debug.php # debug 输出模板
│ ├── 404.php # 404 页面模板
│ └── jump.php # 跳转页面模板
├── vendor/ # Composer 依赖目录
├── startmvc.php # 命令行入口(仅 CLI 可用,Web 访问返回 403)
├── composer.json # Composer 配置
├── .env.example # 环境变量示例
└── README.md

app、extend、startmvc 目录遵循 PSR-4 自动载入规范,类名与文件名一致,首字母均为大写。只有 public 目录需要暴露给 Web,其余目录建议放在 Web 根目录之外或通过服务器规则禁止直接访问。