Laravel 大将之 View 模块

本文是基于Laravel 5.4版本的View模块代码进行分析书写；

文件结构

View模块的文件格局及功能如下图所示：

视图化呈现时的大概流程：

1. 通过view()方法的调用，开始视图的呈现；
2. 首先，查找视图文件；
   （1）依次遍历路径，如果文件名带命名空间（也就是::之前的部分），则采用命名空间对应注册的路径数组，否则采用全局路径数组（在Illuminate\View\FileViewFinder类中的paths变量）；
   （2）结合当前路径，文件名，后缀名（默认顺序是blade.php、php、css），判断文件是否存在；
   （3）如果文件不存在，报异常：对应的view文件不存在；如果文件存在，则根据后缀名调用对应的引擎进行解析；
3. 如果是css后缀，采用file引擎，核心调用方法是file_get_contents;

4. 如果是php后缀，采用php引擎，核心调用方法是

   ob_start();
   include $__path;
   ob_get_clean();

5. 如果是blade.php后缀，采用blade引擎；
   这个引擎会主动作缓存处理，如果缓存文件未过期，则直接调用缓存文件，否则重新编译，并通过sha1生成缓存文件（位于storage/framework/views目录下）；

Blade 引擎编译

Blade引擎对文件的编译，是通过大量的正则匹配和替换实现的；

protected $compilers = [ 
    'Comments',   // 注释部分
    'Extensions', // 扩展部分
    'Statements', // 语句块 （@ 开头的指令）
    'Echos',      // 输出
];

protected function parseToken($token) {
    list($id, $content) = $token;
    
    if ($id == T_INLINE_HTML) {
        foreach ($this->compilers as $type) {
            $content = $this->{"compile{$type}"}($content);
        }
    }
}

在解析的过程中，Blade会先使用token_get_all函数获取视图文件中的被PHP解释器认为是HTML（T_INLINE_HTML）的部分，然后依次进行Comments、Extensions、Statements 和 Echos部分的正则替换；

注释部分
核心代码如下，将注释符号“{{-- --}}”包裹的代码替换为空字符串；

preg_replace("/{{--(.*?)--}}/s", '', $value);

扩展部分
通过extend方法向BladeCompiler添加自定义处理的回调函数，对模板内容进行自定义的文本匹配替换；

核心代码在Illuminate\View\BladeCompiler文件中，如下：

// 自定义的文本替换扩展 数组
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、@endcannot
• Concerns\CompilesComponents：与组件、插槽相关
  指令包括：@component、@endcomponent、@slot、@endslot
• Concerns\CompilesConditionals：与判断语句相关
  指令包括：@if、@unless、@else、@elseif、@endif、@endunless、@isset、@endisset、@hassection
• Concerns\CompilesIncludes：嵌入文件
  指令包括：@each、@include、@includeif、@includewhen
• Concerns\CompilesInjections：服务注入
  指令包括：@inject
• Concerns\CompilesLayouts：和布局相关
  指令包括：@extends、@section、@parent、@yield、@show、@append、@overwrite、@stop、@endsection
• Concerns\CompilesLoops：与循环相关
  指令包括：@forelse、@empty、@endforelse、@endempty、@for、@foreach、@break、@continue、@endfor、@endforeach、@while、@endwhile
• Concerns\CompilesRawPhp：与原生PHP语句相关
  指令包括：@php、 @endphp、 @unset
• Concerns\CompilesStacks：和堆栈相关
  指令包括：@stack、@push、@endpush、@prepend、@endprepend
• Concerns\CompilesTranslations：与本地化翻译相关
  指令包括：@lang、@endlang、@choice

Echo 替换
echo输出是针对{!! !!}、{{ }}、{{{ }}}三种括号进行正则替换；

• {!! !!}输出未转义字符，用于输出原生带html标签的值；
• {{ }}正常输出，支持三目运算符替换；
• {{{ }}}输出转义字符，支持三目运算符替换；

三目运算符替换是指：{{ $a ?: "默认值" }} (或者 {{$a or "默认值"}}) 换成 {{ isset($a) ? $a : "默认值"}}

参考文章

• Laravel 模板引擎（Blade）原理简析
• Laravel 5.4 文档 前端 —— Blade模板