本篇内容我们对ThinkPHP`5.0`的应用请求的生命周期做大致的介绍,以便于开发者了解整个执行流程。
## 1、入口文件
用户发起的请求都会经过应用的入口文件,通常是 `public/index.php`文件。当然,你也可以更改或者增加新的入口文件。
通常入口文件的代码都比较简单,一个普通的入口文件代码如下:
~~~
// 应用入口文件
// 定义项目路径
define('APP_PATH', __DIR__ . '/../application/');
// 加载框架引导文件
require __DIR__ . '/../thinkphp/start.php';
~~~
一般入口文件以定义一些常量为主,支持的常量请参考后续的内容或者附录部分。
> 通常,我们不建议在应用入口文件中加入过多的代码,尤其是和业务逻辑相关的代码。
## 2、引导文件
接下来就是执行框架的引导文件,`start.php`文件就是系统默认的一个引导文件。在引导文件中,会依次执行下面操作:
* 加载系统常量定义;
* 加载环境变量定义文件;
* 注册自动加载机制;
* 注册错误和异常处理机制;
* 加载惯例配置文件;
* 执行应用;
`start.php`引导文件首先会调用`base.php`基础引导文件,某些特殊需求下面可能直接在入口文件中引入基础引导文件。
> 如果在你的应用入口文件中更改了默认的引导文件,则上述执行流程可能会跟随发生变化。
## 3、注册自动加载
系统会调用 `Loader::register()`方法注册自动加载,在这一步完成后,所有符合规范的类库(包括`Composer`依赖加载的第三方类库)都将自动加载。
系统的自动加载由下面主要部分组成:
1. 注册系统的自动加载方法 **`\think\Loader::autoload`**
2. 注册系统命名空间定义
3. 加载类库映射文件(如果存在)
4. 如果存在`Composer`安装,则注册**`Composer`**自动加载
5. 注册`extend`扩展目录
一个类库的自动加载检测顺序为:
1. 是否定义类库映射;
2. `PSR-4`自动加载检测;
3. `PSR-0`自动加载检测;
可以看到,定义类库映射的方式是最高效的。
## 4、注册错误和异常机制
执行`Error::register()`注册错误和异常处理机制。
由三部分组成:
* 应用关闭方法:`think\Error::appShutdown`
* 错误处理方法:`think\Error::appError`
* 异常处理方法:`think\Error::appException`
> 注册应用关闭方法是为了便于拦截一些系统错误。
在整个应用请求的生命周期过程中,如果抛出了异常或者严重错误,均会导致应用提前结束,并响应输出异常和错误信息。
## 5、应用初始化
执行应用的第一步操作就是对应用进行初始化,包括:
* 加载应用(公共)配置;
* 加载扩展配置文件(由`extra_config_list`定义);
* 加载应用状态配置;
* 加载别名定义;
* 加载行为定义;
* 加载公共(函数)文件;
* 注册应用命名空间;
* 加载扩展函数文件(由`extra_file_list`定义);
* 设置默认时区;
* 加载系统语言包;
## 6、URL访问检测
应用初始化完成后,就会进行URL的访问检测,包括`PATH_INFO`检测和URL后缀检测。
5.0的URL访问必须是`PATH_INFO`方式(包括兼容方式)的URL地址,例如:
~~~
http://serverName/index.php/index/index/hello/val/value
~~~
所以,如果你的环境只能支持普通方式的URL参数访问,那么必须使用
~~~
http://serverName/index.php?s=/index/index/hello&val=value
~~~
如果是命令行下面访问入口文件的话,则通过
~~~
$php index.php index/index/hello/val/value...
~~~
获取到正常的`$_SERVER['PATH_INFO']`参数后才能继续。
## 7、路由检测
如果开启了`url_route_on`参数的话,会首先进行URL的路由检测。
如果一旦检测到匹配的路由,根据定义的路由地址会注册到相应的URL调度。
5.0的路由地址支持如下方式:
* 路由到模块/控制器/操作;
* 路由到外部重定向地址;
* 路由到控制器方法;
* 路由到闭包函数;
* 路由到类的方法;
> 路由地址可能会受域名绑定的影响。
如果关闭路由或者路由检测无效则进行默认的**模块/控制器/操作**的分析识别。
> 如果在应用初始化的时候指定了应用调度方式,那么路由检测是可选的。
可以使用 \think\App::dispatch() 进行应用调度,例如:
App::dispatch(['type' => 'module', 'module' => 'index/index']);
## 8、分发请求
在完成了URL检测和路由检测之后,路由器会分发请求到对应的路由地址,这也是应用请求的生命周期中最重要的一个环节。
在这一步骤中,完成应用的业务逻辑及数据返回。
建议统一使用`return`返回数据,而不是`echo`输出,如非必要,请不要使用`exit`或者`die`中断执行。
> 直接`echo`输出的数据将无法进行自动转换响应输出的便利。
下面是系统支持的分发请求机制,可以根据情况选择:
### 模块/控制器/操作
这是默认的分发请求机制,系统会根据URL或者路由地址来判断当前请求的模块、控制器和操作名,并自动调用相应的访问控制器类,执行操作对应的方法。
该机制下面,首先会判断当前模块,并进行模块的初始化操作(和应用的初始化操作类似),模块的配置参数会覆盖应用的尚未生效的配置参数。
支持模块映射、URL参数绑定到方法,以及操作绑定到类等一些功能。
### 控制器方法
和前一种方式类似,只是无需判断模块、控制器和操作,直接分发请求到一个指定的控制器类的方法,因此没有进行模块的初始化操作。
### 外部重定向
可以直接分发请求到一个外部的重定向地址,支持指定重定向代码,默认为301重定向。
### 闭包函数
路由地址定义的时候可以直接采用闭包函数,完成一些相对简单的逻辑操作和输出。
### 类的方法
除了以上方式外,还支持分发请求到类的方法,包括:
静态方法: `'blog/:id'=>'\org\util\Blog::read'`
类的方法:`'blog/:id'=>'\app\index\controller\Blog@read'`
## 9、响应输出
控制器的所有操作方法都是`return`返回而不是直接输出,系统会调用`Response::send`方法将最终的应用返回的数据输出到页面或者客户端,并自动转换成`default_return_type`参数配置的格式。所以,应用执行的数据输出只需要返回一个正常的PHP数据即可。
## 10、应用结束
事实上,在应用的数据响应输出之后,应用并没真正的结束,系统会在应用输出或者中断后进行日志保存写入操作。
系统的日志包括用户调试输出的和系统自动生成的日志,统一会在应用结束的时候进行写入操作。
而日志的写入操作受日志初始化的影响。
- 序言
- 基础
- 安装ThinkPHP
- 开发规范
- 目录结构
- 架构
- 架构总览
- 生命周期
- 入口文件
- URL访问
- 模块设计
- 命名空间
- 自动加载
- Traits引入
- API友好
- 配置
- 配置目录
- 配置格式
- 配置加载
- 读取配置
- 动态配置
- 独立配置
- 配置作用域
- 环境变量配置
- 路由
- 路由模式
- 路由定义
- 批量注册
- 变量规则
- 组合变量
- 路由参数
- 路由地址
- 资源路由
- 快捷路由
- 路由别名
- 路由分组
- MISS路由
- 闭包支持
- 路由绑定
- 绑定模型
- 域名路由
- URL生成
- 控制器
- 控制器定义
- 控制器初始化
- 前置操作
- 跳转和重定向
- 空操作
- 空控制器
- 多级控制器
- 分层控制器
- Rest控制器
- 自动定位控制器
- 资源控制器
- 请求
- 请求信息
- 输入变量
- 更改变量
- 请求类型
- 请求伪装
- HTTP头信息
- 伪静态
- 方法注入
- 属性注入
- 参数绑定
- 依赖注入
- 请求缓存
- 数据库
- 连接数据库
- 基本使用
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询方法
- 查询语法
- 链式操作
- where
- table
- alias
- field
- order
- limit
- page
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- bind
- partition
- strict
- failException
- sequence
- 聚合查询
- 时间查询
- 高级查询
- 视图查询
- 子查询
- 原生查询
- 查询事件
- 事务操作
- 监听SQL
- 存储过程
- 数据集
- 分布式数据库
- 模型
- 定义
- 模型初始化
- 新增
- 更新
- 删除
- 查询
- 聚合
- 获取器
- 修改器
- 时间戳
- 只读字段
- 软删除
- 类型转换
- 数据完成
- 查询范围
- 模型分层
- 数组访问和转换
- JSON序列化
- 事件
- 关联
- 一对一关联
- 一对多关联
- 远程一对多
- 多对多关联
- 多态关联
- 动态属性
- 关联预载入
- 关联统计
- 聚合模型
- 视图
- 视图实例化
- 模板引擎
- 模板赋值
- 模板渲染
- 输出替换
- 模板
- 模板定位
- 模板标签
- 变量输出
- 系统变量
- 请求参数
- 使用函数
- 使用默认值
- 使用运算符
- 三元运算
- 原样输出
- 模板注释
- 模板布局
- 模板继承
- 包含文件
- 标签库
- 内置标签
- 循环输出标签
- 比较标签
- 条件判断
- 资源文件加载
- 标签嵌套
- 原生PHP
- 定义标签
- 日志
- 介绍
- 日志驱动
- 日志写入
- 独立日志
- 日志清空
- 写入授权
- 错误和调试
- 调试模式
- 异常处理
- 抛出异常
- Trace调试
- 变量调试
- 性能调试
- SQL调试
- 远程调试
- 404页面
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 控制器验证
- 模型验证
- 内置规则
- 静态调用
- 表单令牌
- 安全
- 输入安全
- 数据库安全
- 上传安全
- 其它安全建议
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 分页
- 上传
- 验证码
- 图像处理
- 文件处理
- 单元测试
- 扩展
- 函数
- 类库
- 行为
- 驱动
- Composer包
- Time
- 数据库迁移工具
- Workerman
- MongoDb
- SAE
- 标签扩展
- 命令行
- 自动生成目录结构
- 创建类库文件
- 生成类库映射文件
- 生成路由缓存
- 清除缓存文件
- 生成配置缓存文件
- 生成数据表字段缓存
- 自定义命令行
- 部署
- 虚拟主机环境
- Linux 主机环境
- URL重写
- 附录
- 配置参考
- 常量参考
- 助手函数
- 升级指导
- 更新日志