这是一个基于 Webman 框架构建的基础项目模板,旨在提供一个高性能、易于使用的 PHP 应用开发基础。项目集成了多种常用组件和技术,适合构建 Web 应用、API 接口、后台管理系统等。
- 核心框架: Webman 2.x
- PHP 版本: >= 8.2
- 数据库迁移: Phinx
- ORM: Laravel Eloquent
- 后台管理: Amis 可视化页面构建工具
- API 文档: Swagger/OpenAPI
- 测试框架: PestPHP
- 代码质量: PHPStan
- 国际化: Symfony Translation / Laravel Translation
.
├── app/ # 应用主要逻辑代码
│ ├── admin/ # 后台管理模块
│ │ ├── controller/ # 控制器
│ │ │ └── repository/ # 数据仓库
│ │ └── route.php # 路由配置
│ ├── api/ # API接口模块
│ │ ├── controller/ # 控制器
│ │ │ └── form/ # 表单验证
│ │ └── route.php # 路由配置
│ ├── user/ # 用户模块
│ │ ├── controller/ # 控制器
│ │ └── route.php # 路由配置
│ ├── bootstrap/ # 启动文件
│ ├── command/ # 命令行工具
│ │ └── framework/ # 框架命令行工具
│ ├── components/ # 核心组件
│ ├── enums/ # 枚举类型定义
│ │ └── common/ # 通用枚举
│ ├── event/ # 事件
│ ├── exception/ # 异常处理
│ │ └── handlers/ # 异常处理器
│ ├── middleware/ # 中间件
│ ├── model/ # 数据模型
│ │ └── traits/ # 通用特性
│ ├── process/ # 进程
│ ├── queue/ # 队列
│ └── functions.php # 全局函数
├── config/ # 配置文件
│ ├── plugin/ # 插件配置
│ └── app.php # 应用配置
├── docs/ # 项目文档
├── public/ # 静态资源文件
├── resource/ # 资源文件
│ ├── database/ # 数据库相关
│ │ └── migrations/ # 数据库迁移文件
│ ├── phpstan/ # PHPStan配置
│ └── translations/ # 翻译文件
├── support/ # 辅助类和门面模式封装
│ ├── facade/ # 门面模式封装(核心类入口)
│ ├── Request.php # 请求类
│ └── Response.php # 响应类
└── tests/ # 测试文件
├── Feature/ # 功能测试
├── Unit/ # 单元测试
└── TestCase.php # 测试基类
- admin模块: 提供后台管理界面,基于Amis实现可视化操作界面
- api模块: 提供RESTful API接口,并集成Swagger文档
- components模块: 封装了项目通用的基础组件
- enums模块: 定义项目中使用的枚举类型
- model模块: 数据模型,基于Laravel Eloquent ORM