本文是基于Laravel 5.4版本的View模块代码进行分析书写;
官方 API 地址 https://laravel.com/api/5.4/Illuminate/View.html
文件结构
View模块的文件格局及功能如下图所示:
视图化呈现时的大概流程:
- 通过
view()方法的调用,开始视图的呈现; - 首先,查找视图文件;
(1)依次遍历路径,如果文件名带命名空间(也就是::之前的部分),则采用命名空间对应注册的路径数组,否则采用全局路径数组(在Illuminate\View\FileViewFinder类中的paths变量);
(2)结合当前路径,文件名,后缀名(默认顺序是blade.php、php、css),判断文件是否存在;
(3)如果文件不存在,报异常:对应的view文件不存在;如果文件存在,则根据后缀名调用对应的引擎进行解析; - 如果是
css后缀,采用file引擎,核心调用方法是file_get_contents; 如果是
php后缀,采用php引擎,核心调用方法是1
2
3ob_start();
include $__path;
ob_get_clean();如果是
blade.php后缀,采用blade引擎;
这个引擎会主动作缓存处理,如果缓存文件未过期,则直接调用缓存文件,否则重新编译,并通过sha1生成缓存文件(位于storage/framework/views目录下);
Blade 引擎编译
Blade引擎对文件的编译,是通过大量的正则匹配和替换实现的;
1 | protected $compilers = [ |
在解析的过程中,Blade会先使用token_get_all函数获取视图文件中的被PHP解释器认为是HTML(T_INLINE_HTML)的部分,然后依次进行Comments、Extensions、Statements 和 Echos部分的正则替换;
注释部分
核心代码如下,将注释符号“{{-- --}}”包裹的代码替换为空字符串;1
preg_replace("/{{--(.*?)--}}/s", '', $value);
扩展部分
通过extend方法向BladeCompiler添加自定义处理的回调函数,对模板内容进行自定义的文本匹配替换;
核心代码在Illuminate\View\BladeCompiler文件中,如下:1
2
3
4
5
6
7
8
9
10// 自定义的文本替换扩展 数组
protected $extensions = [];
protected function compileExtensions($value) {
foreach ($this->extensions as $compiler) {
$value = call_user_func($compiler, $value, $this);
}
return $value;
}
指令替换
这部分就是将类似@if这种框架自带的指令和通过directive方法注册的指令进行文本替换;
框架提供的指令有以下十部分:
View\Compilers\Concerns\CompilesAuthorizations: 权限检查
指令包括:@can、@cannot、@elsecan、@elsecannot、@endcan、@endcannotConcerns\CompilesComponents:与组件、插槽相关
指令包括:@component、@endcomponent、@slot、@endslotConcerns\CompilesConditionals:与判断语句相关
指令包括:@if、@unless、@else、@elseif、@endif、@endunless、@isset、@endisset、@hassectionConcerns\CompilesIncludes:嵌入文件
指令包括:@each、@include、@includeif、@includewhenConcerns\CompilesInjections:服务注入
指令包括:@injectConcerns\CompilesLayouts:和布局相关
指令包括:@extends、@section、@parent、@yield、@show、@append、@overwrite、@stop、@endsectionConcerns\CompilesLoops:与循环相关
指令包括:@forelse、@empty、@endforelse、@endempty、@for、@foreach、@break、@continue、@endfor、@endforeach、@while、@endwhileConcerns\CompilesRawPhp:与原生PHP语句相关
指令包括:@php、@endphp、@unsetConcerns\CompilesStacks:和堆栈相关
指令包括:@stack、@push、@endpush、@prepend、@endprependConcerns\CompilesTranslations:与本地化翻译相关
指令包括:@lang、@endlang、@choice
Echo 替换echo输出是针对{!! !!}、{{ }}、{{{ }}}三种括号进行正则替换;
{!! !!}输出未转义字符,用于输出原生带html标签的值;{{ }}正常输出,支持三目运算符替换;{{{ }}}输出转义字符,支持三目运算符替换;
三目运算符替换是指:
{{ $a ?: "默认值" }}(或者{{$a or "默认值"}}) 换成{{ isset($a) ? $a : "默认值"}}