TIGERB 的 easy-php 快速入门教程

---

1. 项目目录结构及介绍

easy-php 是一个轻量级的全栈 PHP 框架，它设计目的是为了提供高效且简洁的开发体验。下面是其核心的目录结构以及每个部分的作用：

├── app                 # 应用后端代码目录
│   └── demo            # 示例模块目录
│       ├── controllers  # 控制器目录
│       ├── models       # 模型目录
│       ├── ...
│
├── config              # 配置文件目录
│   ├── demo             # 模块特定配置
│   ├── common.php       # 共享配置
│   ├── database.php     # 数据库配置
│   └── ...
│
├── docs                # API 文档目录
│
├── framework           # 核心框架代码目录
│   ├── handlers         # 处理器类文件，如错误处理、路由等
│   ├── orm              # 对象关系映射（ORM）相关类
│   ├── router           # 路由策略实现
│   ├── ...
│
├── frontend            # 前端源码目录，支持Vue.js等现代前端技术
│
├── jobs                # 定时任务或后台作业脚本目录
│
├── public              # 公开资源目录，如静态文件
│
├── runtime             # 运行时产生的临时文件，包括日志等
│
└── ...

此结构清晰地分离了不同的关注点，便于维护和扩展。

2. 项目启动文件介绍

入口文件位于 public/index.php，它是应用的统一访问入口。这个文件负责初始化框架的核心组件，通过调用 require('.../framework/run.php') 来加载框架运行必要的逻辑，保证客户端请求能够被正确捕获并处理。这是应用生命周期的起点，从这里开始，整个请求流程被触发，包括自动载入、错误处理、路由分发等关键环节。

3. 项目的配置文件介绍

配置文件主要集中在 config 目录下，这些配置文件控制着应用的行为和环境设置。具体来说：

• common.php: 包含通用配置项。
• database.php: 数据库连接参数，定义数据库类型、用户名、密码等。
• nosql.php: 非关系型数据库的配置，如MongoDB、Redis等。
• swoole.php: 如果使用Swoole作为服务器，则包含相关的异步处理和性能优化配置。

在模块内部，比如 config/demo，可以放置模块特有的配置，这有助于实现应用的模块化配置管理，使得不同功能模块可以根据需要独立配置。

小结

通过上述三个关键模块的介绍，你可以快速理解easy-php的架构基础。要启动项目，首先确保你的开发环境中已经安装了PHP，并根据项目需求配置好环境变量。接着，通过运行入口文件或利用提供的脚本来启动服务。记住，深入理解每个配置选项和文件结构对于定制和扩展应用功能至关重要。