本文是基于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
、@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 : "默认值"}}