Laravel 文档阅读：Blade 模板
简介
Blade 是 Laravel 提供的模板引擎，它简单强大。不像其他的 PHP 模板引擎，Blade 允许在视图中使用原生 PHP 代码。实际上，所有的 Blade 视图最终都会被编译成原生 PHP 代码，缓存在 storage/framework/views 文件夹中。Laravel 使用的是这些编译后的缓存文件，而不是视图本身，所以，Blade 对于应用程序来说是零开销的。当你修改了视图文件，那么它会重新编译并缓存，以便使用。Blade 视图以 blade.php 为后缀名，一般存放于 resources/views 文件夹中。
模板继承
定义布局文件
Blade 模板引擎的主要两个优点是 “模板继承” 和 “区块”。举一个简单的例子，一个项目里，几乎所有的页面都是一样的布局，这时候就可以把这个布局提炼出来，作为母版页，继承了这个母版页的的页面都有一样的布局效果，成为母版页的子页。母版页还叫布局文件，布局文件就是一个 Blade 视图：
<!-- Stored in resources/views/layouts/app.blade.php -->
<html>
<head>
<title>App Name - @yield('title')</title>
</head>
<body>
@section('sidebar')
This is the master sidebar.
@show
<div class="container">
@yield('content')
</div>
<body>
</html>
布局文件里除了基础的 HTNL 标签，还使用了两个指令：@section 和 @yield 。@section定义区块，@yield 定义区块里的内容。
下面。来定义布局文件的子页。
继承布局文件
子页中，使用 Blade 的 @extends 指令指定 “继承” 的布局文件，使用 @section 指令为在布局文件中使用 @section 和 @yield 指令的地方注入内容：
<!-- Stored in resources/views/child.blade.php -->
@extends('layouts.app')
@section('title','Page Title')
@section('sidebar')
<p> This is appended to the master sideebar</p>
@endsection
@section('content')
<p>This ismy body content. </p>
@endsection
可以看到，在布局文件中使用 @yield 指令的地方，在子页中仍然使用 @section 注入内容；在布局文件中使用 @section 指令定义的一个好处是：在子页中使用 @section 注入时，可以使用 @parent 指令附加（而非重写）在布局文件中的内容，而在布局文件中使用 @yield 指令定义的地方是做不到的。@parent 指令会在视图渲染的时替换成布局文件里的内容。
注意，与在文件布局里定义的 sidebar 不同的是，子页里使用 @endsection 结束，而非 @show 。因为 @endsection 仅用来定义区块，而 @show 是用来定义、立马产出区块的。
从路由中直接返回视图文件，要用到全局辅助函数 helper :
Route::get('blade', function(){
return view('child');
})
组件&插槽
组件和插槽提供了类似布局和区块的优点。而组件和插槽的心智模型更符合直觉。设想一下，在我们的项目中有一个可重复的 “弹框” 组件：
<!-- Stored resource/views/alter.blade.php -->
<div class="alter alter-danger">
{{ $slot }}
</div>
{{ $slot }} 表示插入组建的内容。构建此组件，是使用 Blade 的@component指令：
@component('alter')
<strong>Whoops!</strong> Something went wrong!
@endcomponent
在这个场景里，{{ $slot }} 变量的内容是：
<strong>Whoops! </strong> Something went wrong!
有时一个组件需要多个插槽。这时，只需要稍改组件代码，定义一个 “标题” 插槽，这个插槽称命名插槽。命名插槽是通过简单的 “打印” 匹配其名称的变量来显示内容的：
<!-- Stored resources/views/alter.blade.php-->
<div class="alter alter-danger">
<div class="alter-title">{{ $title }}</div>
{{ $slot }}
</div>
为名名插槽注入内容，使用 @slot 指令。所有不在 @slot 指令里的内容都会传递给组件里的 $slot 变量。
@compontent ('alter')
@slot('title')
Forbidden
@endslot
You are not allowed to access this resource!
@edcompontent~
为组建传递额外数据：
有时需要为组建件递额外数据。为此，可以为 @conponent 指令传递第二个数组参数。指定要传递的额外。据所有过去的额外数据作为变量，在组件模板里都可以取的：
@component
<compontent('alter', ['foo' => 'bar');
.....
@endCompontent
显示数据
向 Blade 视图传递数据，是通过将变量包裹在 [ ] 里实现的：
Route::get('greeting', function(){
return view('welcome', [ 'name' => ''Samantha']);
})
下面就可以使用 name 变量显示内容了：
Hello! {{ $name }}
{{ }} 是 Blade 视图的打印语句，当然，打印语句里不限制只能打印变量内容，也可以使用 PHP 函数。实际上，打印语句这里可以使用任何 PHP 代码：
The current UNIX timestamp is {{ time() }}
显示非转移数据
默认，所有传递给 Blade {{ }} 语句的内容都会使用 htmlspecialchar 函数处理、将内容转义，避免 XSS 攻击。如果无需转义输出的内容，可以使用下面语法：
Hello! {{!! $name !!}}.
不过千万要小心，应该优先选择使用转义的 {{ }} 语法避免 XXS 攻击。因为，有时你很难避免用户有意的、无意的数据输入。
Blade & JavaScript 框架
由于一些 JavaScript 框架也使用花括号 {{ }} 语法解析内容，为了区分开 Blade 和这些用到的 JavaScript 框架，你可以使用 @ 符号来告诉 Blade 模板引擎说，这个地方不要动，保持原样就可以了：
<h1>Laravel</h1>
Hello! @{{ $name }}
上面例子里， @ 符号会从 Blade 中删除，而 {{ $name }} 会保持原样，用来给你的 JavaScript 框架渲染使用。
@verbatim 指令
如果使用 JavaScript 框架渲染的模块区域很大，这时就可以使用 @verbatim 指令包裹这些模板区域，这样就避免了在每个Blade 打印语句前都跟上 @ 符号的麻烦：
@verbatim
<div class="container">
Hello! {{ $name }}
</div>
@endverbatim
控制结构
除了模板继承和显示数据，Blade 还未常见的 PHP 结构提供了快捷方式，比如条件谈判和循环。这些快捷方式提供了一种非常干净、简洁的控制结构，并且保持了原生 PHP 的形式。
if 语句
构造 if 语句使用 @if 、@elseif 、@else 和 endif 指令。这些指令和原生 PHP 的控制功能一一对应：
@if(count($records) === 1)
I have one record!
@ elseif(count($records) > 1)
I have multiple records!
@else
I don't have any records!
@endif
为了方便，Blade 还提供了 @unless 指令：
@unless(Auth::check())
You are not signed in.
@endless
除了讨论过的条件判断指令，Blade 还提供了 @isset 和 @empty 指令，都与在原生 PHP 里的对应功能相同：
@isset($recodes)
// $recodes is defined and is not null ...
@endisset
@empty($recodes)
// $recodes is "empty" ...
@endempty
认证
@auth 和 @guest 指令用来判断当前用户是认证用户还是游客：
@auth
// The user is authenticated...
@endauth
@guest
// The useris not authenticated...
@endguest
Switch 语句
switch 语句使用 @switch 、@case 、@break、@default 和 @endswitch 指令构建：
@switch($i)
@case(1)
First case...
@break;
@case(2)
Second case...
@break;
@default
Default case...
@endswitch
循环
Blade 还提供了循环方面的指令。再一次声明：这里的每一个指令都与原生 PHP 里的对应功能相同。
@for ($i = 0;$i < 10, $i++)
The current value is {{ $i }}
@endfor
@foreach($users as $user)
<p>This is user {{ $user->id }} </p>
@endforeach
@forelse($users as $user)
<li> {{ $user->name }}</li>
@empty
<p>No user </p>
@endforelse
@while(true)
<p>I'm looping forever.</p>
@endwhile
在循环时可以结束或跳出当前的迭代：
@foreach($users as $user)
@if ($user->type == 1)
@continue
@endif
<li>{{ $user->name }}</li>
@break($user->number == 5)
@endforeach
$loop 变量
在循环时，内部有一个可用变量 $loop 。这个变量提供了跟循环有关的有用信息，比如当前迭代的索引、是否是第一次、最后一次迭代等：
@foreach($users as $user)
@if ($loop->first)
This is the first iteration.
@endif
@if ($loop->last)
This is the last iteration.
@endif
<p>This is user {{ $user->id }}</p>
@endforeach
如果是在嵌套的循环里，就可以使用 $loop 变量的 parent 属性父级循环里的 $loop 变量：
@foreach($users as $user)
@foreach($user->posts as $post)
@if ($loop->parent->first)
This is first iteration of the parent loop.
@endif
@endforeach
@endforeach
$loop 变量提供的有用属性列举如下：
image.png
注释
Blade 的注释语法是 {{-- --}} 。不像 HTML 注释，Blade 模板注释不会出现在最终渲染的 HTML 代码里：
{{-- This is comment will not be present in the rendered HTML --}}
PHP
Blade 允许在一个视图里通过 @include 指令引入一个视图。使用 @include 指令的视图称为父级视图，引入的视图称为子视图。父级视图的所有变量在子视图里都是可以获得的：
<div>
@include('shared.error')
<form>
<!-- Form Contents -->
</form>
</div>
虽然子视图会继承父级视图内的所有变量，但是你也可以为引入的子视图传递额外数据，这些数据是以数组的形式传递过去的：
@include('view.name',['some' => 'data'])
当你用 @include 引入的视图不存在时， Laravel 会抛出错误。如果引入的试图不确定是否存在，应该使用 @includeIf 指令：
@includeIf('view.name', ['some' => 'data'])
如果要通过一个布尔值判断是否引入子视图，需要使用 @includeWhen 指令：
@includeWhen($boolean, 'view.name', ['some' => 'data'])
注意：不要使用 __DIR__ 和 __FILE__ 常量引入 Blade 视图，因为程序实际使用的是编译后的、缓存在 storage/framework/views 文件夹中的文件。
为集合渲染视图
@each 指令整合了循环数据和引入视图的功能：
@each(''view.name', $job, 'job')
第一个参数是为数组或者集合中每个元素渲染数据时指定的视图，第二个参数是要便利的数组或集合，第三个参数是当前迭代的元素数据在子视图中的变量名。在上面的例子里，我们遍历的数组是 jobs , 在 view.name 视图里渲染 job 变量，当前迭代的 key 使用 key 变量获取。
也可以为 @each 指令传递第四个参数，这是在给定数组元素为空时渲染的视图：
@each($bollean, 'view.name', [ 'some' => 'data'], 'view.empty')
注意：使用 @each 渲染的视图不从父级模板里继承变量。如果子视图还需要这些变量，你应该使用 foreach 和 @include 指令组合。
堆栈
Blade 允许你使用 @push 指令向命名堆栈里推入内容，命令堆栈以 @stack 指令定义，可以定义在普通视图或者布局文件里，推入的内容会在视图或者布局文件里渲染出来。这在为子视图添加额外的 JavaScript 库的场景下特别有用。
<!-- 在视图或者布局文件里定义堆栈 -->
<head>
<!-- Head Contents -->
@stack('scripts')
</head>
<!-- 在子视图中推入堆栈内容 -->
@push('scripts')
<script src="/example.js"></script>
@endpush
你可以尽你自己所需的多次向堆栈推入数据。
服务注入
@inject 指令可以从 Laravel 的服务提供者中获得服务。传递给 @inject 指令的第一个参数是一个变量名，获得的服务就是存放在这个变量里，第二个参数就是你要解析的服务的类名或接口名。
@inject('metrics', 'App\Services\MetricesService')
<div>
Monthly Revenue: {{ $metrics->monthlyRevenue() }}.
</div>
扩展 Blade
Blade 允许你使用 directive 方法创建自定义指令。当 Blade 方法遇到自定义指令时，会将接收到的表达式 （expression）放在自定义指令的回调闭包里处理。
在下面的例子里，我们创建了一个 @datatime($var) 指令，$var应该是一个DateTime 实例：
namespace App\Providers;
use Illuminate\Support\Facades\Blade;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot()
{
Blade::directive('datetime', function($expression){
return "<?php echo ($expression->format('m/d/Y H:i'); ?>)";
});
}
/**
* Register bindings in the container.
*
* @return void
*/
public function register()
{
//
}
}
可以看到，我们在传过来的表达式上使用了 format 方法。在这个例子里，@datetime($var) 指令最终生成的 PHP 代码如下：
<?php echo ($var)->format('m/d/Y H:i'); ?>
注意：在更新自定义指令后，需要删除所有的视图文件，可以用 view:cache Artisan 命令实现。
自定义 if 语句
当自定义涉及简单的条件判断时，使用 Blade::directive 的方式可能会变得稍复杂些。为此， Blade 引入了 Blade::if 方法使用闭包来快速自定义条件判断指令。例如，我们定义一个指令，判断当前的项目环境，可以选择在 AppServiceProvider 的 boot 里做这件事情：
use Illuminate\Support\Facades\Blade;
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot()
{
Blade::if('env', function($expression){
return app()->environment($environment);
})
}
定义好后，咱使用它：
@env('local')
// The application is in the local environment...
@else
// The application is not in the local environment...
@endenv
是不是很简单呢 ？？
