Laravel 大将之 View 模块

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

官方 API 地址 https://laravel.com/api/5.4/Illuminate/View.html

文件结构

View模块的文件格局及功能如下图所示:
图片描述

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

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

    1
    2
    3
    ob_start();
    include $__path;
    ob_get_clean();
  5. 如果是blade.php后缀,采用blade引擎;
    这个引擎会主动作缓存处理,如果缓存文件未过期,则直接调用缓存文件,否则重新编译,并通过sha1生成缓存文件(位于storage/framework/views目录下);

Blade 引擎编译

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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解释器认为是HTMLT_INLINE_HTML)的部分,然后依次进行CommentsExtensionsStatementsEchos部分的正则替换;

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

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@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 : "默认值"}}

参考文章