laravel 基础教程 —— Blade 模板引擎

Blade 模板引擎

简介

Blade 是 laravel 提供的一个差不离强大的模板引擎。它不像别的流行的 PHP
模板引擎这样限制你在视图中采用原生的 PHP 代码,事实上它就是把 Blade
视图编译成原生的 PHP 代码并缓存起来。缓存会在 Blade
视图改变一下改变,那表示 Blade 并从未给你的利用添加编译的承受。Blade
视图文件使用 .blade.php 后缀,一般意况下都被贮存在 resources/views
目录。

模板继承

概念布局

Blade
带来的五个重点的惠及就是模板继承和挂件。为了有利于起来,我们来看2个粗略的事例。首先,大家创建壹个主页面布局。因为大多数web
应用是在差别的页面中应用同一的总体布局,大家可以方便的定义这一个布局为独立的
Blade 视图:

<!-- Stored in resources/views/layouts/master.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>

从地点的例证你可以看看,Blade 模板文件包含了独立的 HTML
标记。你肯定注意到了 @section@yield 指令。@section
指令似乎它的名字所暗示的那样定义了二个情节区块,而 @yield
指令是用来突显所提供的挂件区块所包含的始末。

明天我们早就定义好了多个基本的布局,接下去大家来营造1个子页面去继承这些布局。

伸张布局

我们得以应用 Blade 的 @extends 指令来远近出名的指定继承有些布局。然后采纳
@section
指令将挂件中的内容挂载到布局中,在地点的事例中,挂件的内容将被挂载到布局中的
@yield 部分:

<!-- Stored in resoures/views/child.blade.php -->

@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  @parent

  <p>This is appended to the master sidebar.</p>
@endsection

@section('content')
  <p>This is my body content.</p>
@endsection

在上面的事例功用 sidebar 挂件利用 @parent 指令来充实布局中的 sidebar
部分的情节,假如不利用则会覆盖掉布局中的那部分。@parent
指令会在视图被渲染时替换为布局中的内容。
Blade 视图可以像原生 PHP 视图一样选拔全局支持函数 view
来重回渲染后的情节:

Route::get('blade', function () {
  return view('child');
});

展现数据

您可以接纳花括号 {
来在视图中显得传递到视图中的变量,例如,你定义了下边的路由:

Route::get('greeting', function () {
  return view('welcome', ['name' => 'Samantha']);
})

您可以在视图中如此来输出 name 变量的内容:

Hello, {{ $name }}

本来,你并没有被限制只同意呈现传递到视图中的变量的情节。你也足以从原生
PHP 方法中回到内容。事实上,你可以在 Blade echo 申明中应用任意的 PHP
代码:

The current UNIX timestamp is {{ time() }}

注意:Blade {{}} 注脚中的内容是半自动通过 PHP 的 htmlentities
方法过滤的,用来防护 XSS 攻击。

Blade & JavaScript Frameworks

鉴于许多 JavaScript
框架都使用花括号来注明所提供的表明式应该被出示在浏览器中。所以你可以运用
@ 符号来报告 Blade 渲染引擎你必要以此表明式原样保留:

<h1>Laravel</h1>

Hello, @{{ name }}

位置的例证中,@ 符号会在 Blade 渲染时被移除,并且 {{ name }}
表明式会被形容保留下去。

出口数据纵然它存在

有时候你恐怕希望输出3个变量,但是你并不分明它是还是不是已经被安装,你可以运用这一个表明式:

{{ isset($name) ? $name : 'Default' }}

Blade 提供了多个方便的点子来替换那个三元评释:

{{ $name or 'Default' }}

下边的事例中,倘若变量 $name 存在,它将被输入,倘诺不设有,Default
会被输出。

体现未转义的多少

默认的,Blade {{}} 表明会自动的应用 PHP 的 htmlentities 方法来幸免XSS 攻击。借使你不想你的数码被转义,你可以行使上边的语法:

Hello, {!! $name !!}

注意:当您在应用中输出用户输入的数量时应当十三分的严俊,你应当总是采用
{{}} 来转义内容中自由的 HTML 实体。

控制结构

除去模板继承和多少呈现,Blade 为通用的 PHP
控制结构提供了有利于的简写形式,比如条件表明和循环。那些简写提供了几个根本简单的方法来处理
PHP 的控制结构,而且还保持与 PHP 语句的相似性。

if 声明

您可以经过 @if,@elseif,@else@endif 指令来行使 if
控制结构,那一个指令和 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.
@endunless

你也足以使用 @hasSection 指令来判断提需求布局的挂件是或不是含有了情节:

<title>
  @hasSection('title')
    @yield('title') - App Name
  @else
    App Name
  @endif
</title>

循环

除却标准注脚,Blade 也提供了一部分简练指令来支撑 PHP
的巡回结构。那个指令方法和 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 users</p>
@endforelse

@while (true)
  <p>I'm looping forever.</p>
@endwhile

Blade 也提供了甘休迭代或注销当前迭代的吩咐:

@foreach ($users as $user)
  @if($user->type == 1)
    @continue
  @endif

  <li>{{ $user->name }}</li>

  @if($user->number == 5)
    @break
  @endif
@endforeach

您也可以行使指令评释包涵条件的点子来达到中断:

@foreach ($users as $user)
  @continue($user->type == 1)

  <li>{{ $user->name }}</li>

  @break($user->number == 5)
@endforeach

包涵子视图

您可以应用 @include
指令来含有1个视图的情节,当前视图中的变量也会被共享给子视图:

<div>
  @include('shared.errors')

  <form>
  <!-- Form Contents -->
  </form>
</div>

即便敬仲视图会自动三番五次父视图中的全体数据变量,你也足以间接传送二个数组变量来添加额外的变量到子视图:

@include('view.name', ['some' => 'data'])

关键:你应该在 Blade 视图中幸免接纳 __DIR____FILE__
常量,因为它们会分析为视图缓存所在的职位。

为汇集渲染视图

您可以拔取 Blade 的 @each 指令来在一行中联合引入三个视图:

@each('view.name', $jobs, 'job')

率先个参数是数组或集合中各类成分需求被渲染的视图名称。第四个参数是三个数组或集合,被用来提供迭代。而第三个参数是要分配给当下视图的变量名。举个例子,若是您须要遍历壹个数组
jobs,日常你想要在有的渲染的视图中应用 job 作为变量来走访 job 消息。

您也得以传递第多少个参数到 @each
指令。假诺所提供的数组是空数组的话,该参数所提供的视图将会被引入。

@each('view.name', $jobs, 'job', 'view.empty')

注释

Blade 也同意你在视图中定义注释,可是它不会在渲染时生成 HTML 注释:

{{-- This comment will not be present in the rendered HTML --}}

Blade 允许你在已命名的堆中压入内容:

@push('scripts')
  <script src="/example.js"></script>
@endpush

你可以在你需求的时候压入相同的堆任意的次数,你须要在布局中运用 @stack
来渲染堆:

<head>
  <!-- Head Contents -->

  @stack('scripts')
</head>

服务注入

你可以应用 @inject
指令来从劳动容器中取回服务,该指令的首先个参数将用作所取回服务存放的变量名,而第2个参数是你想要在劳务容器中取回的类或接口名称:

@inject('metrics', 'App\Services\MetricsService')

<div>
  Monthly Revenue: {{ $metrice->monthlyRevenue() }}
</div>

扩展 Blade

Blade 允许你自定义一些限令,你可以采取 directvie 方法来注册指令。当
Blade
编译器遭逢该指令时,它会自行的调用该指令注册时提供的回调函数并传递它的参数。

上边的例证创制了 @datetime($val) 指令来格式化 $val:

<?php
namespace App\Providers;

use 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 with{$express}->format('m/d/Y H:i'); ?>";
     });
   }

   /**
    * Register bindings in the container
    *
    * @return void
    */
    public function register()
    {
      //
    }
}

地点的事例中动用了 Laravel 的 with
协助方法,它只是简短的归来1个所提供的目标或值,并提供方便的链式调用。最后该指令生成的
PHP 代码如下:

  <?php echo with($var)->format('m/d/Y H:i'); ?>

在你更新 Blade 指令的逻辑之后,你应该删除全体已缓存的 Blade
视图,你能够使用 view:clear Artisan 命令来扫除。

相关文章