:-: **1 路由解析**
>[danger] 在App的run()方法初始化后，开始进行请求路由解析
>
> 请求解析的过程就是讲url根据注册的路由分派到对应的应用层业务逻辑
>
> 请求解析的实现由/library/think/Route实现
* * * * *
:-: **2 路由解析入口源码分析**
* * * * *
~~~
//App run()方法
// 初始化应用
$this->initialize();
if ($this->bind) {
// 模块/控制器绑定
$this->route->bind($this->bind);
} elseif ($this->config('app.auto_bind_module')) {
// 入口自动绑定
$name = pathinfo($this->request->baseFile(), PATHINFO_FILENAME);
if ($name && 'index' != $name && is_dir($this->appPath . $name)) {
$this->route->bind($name);
}
}
~~~
>[danger] 首先检查App的属性bind，是否绑定到特定模块/控制器
> 如果App的属性bind没有设置，则读取配置的`app.auto_bind_module`。
> 如果设置了自动绑定模块，则将入口文件名绑定为模块名称。
> 比如设置app的auto_bind_module为ture。则访问admin.php入口文件。
> 那么默认的模块就是admin模块
~~~
// 监听app_dispatch
$this->hook->listen('app_dispatch');
~~~
调用app_dispatch的回调函数
~~~
$dispatch = $this->dispatch;
if (empty($dispatch)) {
// 进行URL路由检测
$this->route->lazy($this->config('app.url_lazy_route'));
$dispatch = $this->routeCheck();
}
$this->request->dispatch($dispatch);
~~~
>[danger] 获取应用的调度信息。这里的routeCheck()是路由解析的入口
> 然后将解析的调度信息保存到全局Request对象中。
~~~
if ($this->debug) {
$this->log('[ ROUTE ] ' . var_export($this->request->routeInfo(), true));
$this->log('[ HEADER ] ' . var_export($this->request->header(), true));
$this->log('[ PARAM ] ' . var_export($this->request->param(), true));
}
~~~
>[danger] 调试模式下，保存路由的请求信息到日志文件中
~~~
// 监听app_begin
$this->hook->listen('app_begin');
~~~
>[danger] 调用app_begin的回调函数
~~~
$this->request->cache(
$this->config('app.request_cache'),
$this->config('app.request_cache_expire'),
$this->config('app.request_cache_except')
);
~~~
>[danger]检查否开启了请求缓存，
>如果设置了缓存，则尝试读取缓存结果
~~~
// 执行调度
$data = $dispatch->run();
~~~
>[danger]这里执行调度。也就是执行请求分派到的业务逻辑，
>通常是模块/控制器中的特定方法。也可以是其他形式的业务逻辑
>比如 闭包函数，或者直接返回模板等。
~~~
$this->middlewareDispatcher->add(function (Request $request, $next) use ($data) {
// 输出数据到客户端
if ($data instanceof Response) {
$response = $data;
} elseif (!is_null($data)) {
// 默认自动识别响应输出类型
$isAjax = $request->isAjax();
$type = $isAjax ? $this->config('app.default_ajax_return') : $this->config('app.default_return_type');
$response = Response::create($data, $type);
} else {
$response = Response::create();
}
return $response;
});
$response = $this->middlewareDispatcher->dispatch($this->request);
~~~
>[danger] 这里是think5.1准备添加的中间件功能。
~~~
$this->hook->listen('app_end', $response);
return $response;
~~~
>[danger] 调度执行完后，调用app_end的回调函数
> 最后run()方法返回创建的响应对象Response
>然后在入口文件index.php中调用Response的send()将结果输出到客户端
`Container::get('app')->run()->send();`
:-: **3 路由注册过程源码分析**
>[danger] 由上面的分析可知 路由解析的入口是App的routeCheck()
> 下面开始分析App的routeCheck()是如何解析请求Request得到调度信息的
~~~
//App routeCheck()
$path = $this->request->path();
$depr = $this->config('app.pathinfo_depr');
~~~
>[danger]调用Request的path()方法获取当前请求的pathinfo信息
>然后读取app.pathinfo_depr获取pathinfo的分隔符
>这里的path就是请求的url`index/blog/index`。pathifo_depr也就是url分隔符`/`
~~~
$files = scandir($this->routePath);
foreach ($files as $file) {
if (strpos($file, '.php')) {
$filename = $this->routePath . $file;
// 导入路由配置
$rules = include $filename;
if (is_array($rules)) {
$this->route->import($rules);
}
}
}
~~~
>[danger]这里遍历路由目录/route/中的所有文件。将其中的路由规则导入
>也就是将配置的路由信息加载到框架中。
>然后根据注册的路由信息匹配请求url
~~~
if ($this->config('app.route_annotation')) {
// 自动生成路由定义
if ($this->debug) {
$this->build->buildRoute($this->config('app.controller_suffix'));
}
$filename = $this->runtimePath . 'build_route.php';
if (is_file($filename)) {
include $filename;
}
}
~~~
>[danger]这里检查是否配置了注释自动生成路由
>如果开启了注释路由，则调用Build的buildRoute()解析注释为路由
>然后将解析后的路由文件build_route.php加载到框架中
~~~
$must = !is_null($this->routeMust) ? $this->routeMust : $this->config('app.url_route_must');
return $this->route->check($path, $depr, $must, $this->config('app.route_complete_match'));
~~~
>[danger]检查配置url_route_must是否开启。
>如果开启，则每个请求必须配置路由，否则默认按照模块/控制器/操作解析
>最后调用Route的check()方法在路由中匹配url。返回匹配后的调度信息Dispatch
:-: **4 url与路由匹配过程源码分析**
>[danger]在Route的check()开始在注册的路由中匹配url
~~~
$domain = $this->checkDomain();
~~~
>[danger]首先检查是否注册了请求的域名路由信息。
>注册的域名路由信息保存在Route的domains属性中
>如果注册了域名路由信息，则返回对应的域名路由信息
~~~
$url = str_replace($depr, '|', $url);
~~~
>[danger] 将url的分隔符替换为|
~~~
$result = $domain->check($this->request, $url, $depr, $completeMatch);
~~~
>[danger] 调用域名路由的Check()方法，匹配请求url
>[danger]这里的check()方法在/route/Domain.php文件中
>主要进行路由的别名和url绑定检查 checkouteAlias() checkUrlBind()
>路由的别名和url绑定检查由Route的getAlias()和getBind()实现
>在getAlias()和getBind()中主要读取了Route的alias和bind属性
>检查是否包含了当前url和域名对应的路由信息
>[danger]最后调用Domain的父对象组路由RuleGroup的check()进行路由检查
>在RuleGroup()首先检查跨域请求checkCrossDomain()
>然后检查路由规则的option参数是否有效checkOption()
>然后检查分组路由的url是否匹配checkUrl()
~~~
if ($this->rule) {
if ($this->rule instanceof Response) {
return new ResponseDispatch($this->rule);
}
$this->parseGroupRule($this->rule);
}
~~~
>[danger]如果上述条件都符合，那么当前的路由规则就是请求url对应的路由
>然后读取路由中注册的调度信息rule
>如果注册的路由调度信息rule是调度对象，则直接返回调度对象
>否则调用分组路由解析。也就是生成分组的多条路由调度信息rule
~~~
// 分组匹配后执行的行为
$this->afterMatchGroup($request);
// 获取当前路由规则
$method = strtolower($request->method());
$rules = $this->getMethodRules($method);
if ($this->parent) {
// 合并分组参数
$this->mergeGroupOptions();
}
if (isset($this->option['complete_match'])) {
$completeMatch = $this->option['complete_match'];
}
if (!empty($this->option['merge_rule_regex'])) {
// 合并路由正则规则进行路由匹配检查
$result = $this->checkMergeRuleRegex($request, $rules, $url, $depr, $completeMatch);
if (false !== $result) {
return $result;
}
}
// 检查分组路由
foreach ($rules as $key => $item) {
$result = $item->check($request, $url, $depr, $completeMatch);
if (false !== $result) {
return $result;
}
}
~~~
>[danger]接下来在生成的分组路由的多条调度信息中匹配请求的url
>得到匹配的结果$result。
~~~
if ($this->auto) {
// 自动解析URL地址
$result = new UrlDispatch($this->auto . '/' . $url, ['depr' => $depr, 'auto_search' => false]);
} elseif ($this->miss && in_array($this->miss->getMethod(), ['*', $method])) {
// 未匹配所有路由的路由规则处理
$result = $this->parseRule($request, '', $this->miss->getRoute(), $url, $this->miss->getOption());
} else {
$result = false;
}
return $result;
~~~
>[danger]如果在分组路由中没有找到url对应的路由规则
>则在auto和miss分组路由中尝试匹配。
>最后返回匹配的结果
>也就是生成的调度信息
~~~
if (false === $result && !empty($this->cross)) {
// 检测跨域路由
$result = $this->cross->check($this->request, $url, $depr, $completeMatch);
}
~~~
>[danger]这里返回到Route的路由检查check()方法中
>如果没有匹配到当前url。则检查是否设置跨域路由
>尝试检查跨域路由
~~~
if (false !== $result) {
// 路由匹配
return $result;
} elseif ($must) {
// 强制路由不匹配则抛出异常
throw new RouteNotFoundException();
}
~~~
>[danger]如果得到匹配的路由调度信息则返回$result
>否则检查是否设置强制路由，
>开启强制路由时，匹配路由失败则跑出路由不匹配异常
~~~
return new UrlDispatch($url, ['depr' => $depr, 'auto_search' => $this->config->get('app.controller_auto_search')]);
~~~
>[danger]如果没有开启强制路由，则返回url到模块/控制器/操作的url调度对象
>得到调度对象，返回App的run()中开始记录调度信息到request
>然后调用调度对象Dispatch的run()方法
:-: **5 调度对象的执行**
>[danger]调度对象Dispatch在think中由/route/dispatch/目录中实现
>主要包括继承了基础调度对象dispath的闭包回调，控制器，模块，跳转，url，视图等调度对象
>在url调度对象中调用了模块调度对象，在模块调度对象中最终执行了业务逻辑控制器的操作。
>操作的执行结果返回到App的run()方法中保存到$data
>然后创建对应的响应对象Response
>响应对象在/response/中实现为json,jsonp,jump,redirect,view,xml等响应对象
>其中的view也就是通常的模板响应对象
