Blade 模板 · laravel 5.4

<article><h1>Laravel 的 Blade 模板引擎</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#template-inheritance">模板繼承</a><ul><li><a href="#defining-a-layout">定義頁面布局</a></li><li><a href="#extending-a-layout">繼承頁面布局</a></li></ul></li><li><a href="#components-and-slots">組件 & Slots</a></li><li><a href="#displaying-data">顯示數據</a><ul><li><a href="#blade-and-javascript-frameworks">Blade & JavaScript 框架</a></li></ul></li><li><a href="#control-structures">控制結構</a><ul><li><a href="#if-statements">If 語句</a></li><li><a href="#loops">循環</a></li><li><a href="#the-loop-variable">循環變量</a></li><li><a href="#comments">注釋</a></li><li><a href="#php">PHP</a></li></ul></li><li><a href="#including-sub-views">引入子視圖</a><ul><li><a href="#rendering-views-for-collections">為集合渲染視圖</a></li></ul></li><li><a href="#stacks">堆棧</a></li><li><a href="#service-injection">服務注入</a></li><li><a href="#extending-blade">擴充 Blade</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>Blade 是 Laravel 提供的一個既簡單又強大的模板引擎。和其他流行的 PHP 模板引擎不一樣，Blade 并不限制你在視圖中使用原生 PHP 代碼。所有 Blade 視圖文件都將被編譯成原生的 PHP 代碼并緩存起來，除非它被修改，否則不會重新編譯，這就意味著 Blade 基本上不會給你的應用增加任何額外負擔。Blade 視圖文件使用 <code class=" language-php">.blade.php</code> 擴展名，一般被存放在 <code class=" language-php">resources/views</code> 目錄。<a name="template-inheritance"></a><h2><a href="#template-inheritance">模板繼承</a></h2><a name="defining-a-layout"></a><h3>定義頁面布局</h3>Blade 的兩個主要優點是 模板繼承 和 區塊 。為方便開始，讓我們先通過一個簡單的例子來上手。首先，我們需要確認一個 "master" 的頁面布局。因為大多數 web 應用是在不同的頁面中使用相同的布局方式，我們可以很方便的定義這個 Blade 布局視圖：<pre class=" language-php"><code class=" language-php"> <html> <head> <title>應用程序名稱 - @yield('title')</title> </head> <body> @section('sidebar') 這是 master 的側邊欄。 @show <div class="container"> @yield('content') </div> </body> </html></code></pre>如你所見，該文件包含了典型的 HTML 語法。不過，請注意 <code class=" language-php">@section</code> 和 <code class=" language-php">@yield</code> 命令。 <code class=" language-php">@section</code> 命令正如其名字所暗示的一樣是用來定義一個視圖區塊的，而 <code class=" language-php">@yield</code> 指令是用來顯示指定區塊的內容的。現在，我們已經定義好了這個應用程序的布局，讓我們接著來定義一個繼承此布局的子頁面。<a name="extending-a-layout"></a><h3>繼承頁面布局</h3>當定義子頁面時，你可以使用 Blade 提供的 <code class=" language-php">@extends</code> 命令來為子頁面指定其所「繼承」的頁面布局。當子頁面繼承布局之后，即可使用 <code class=" language-php">@section</code> 命令將內容注入于布局的 <code class=" language-php">@section</code> 區塊中。切記，在上面的例子里，布局中使用 <code class=" language-php">@yield</code> 的地方將會顯示這些區塊中的內容：<pre class=" language-php"><code class=" language-php"> @extends('layouts.app') @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</code></pre>在上面的例子里，<code class=" language-php">sidebar</code> 區塊利用了 <code class=" language-php">@@parent</code> 命令追加布局中的 sidebar 區塊中的內容，如果不使用則會覆蓋掉布局中的這部分內容。 <code class=" language-php">@@parent</code> 命令會在視圖被渲染時替換為布局中的內容。當然，可以通過在路由中使用全局輔助函數 <code class=" language-php">view</code> 來返回 Blade 視圖：<pre class=" language-php"><code class=" language-php">Route::get('blade', function () { return view('child'); });</code></pre><a name="components-and-slots"></a><h2><a href="#components-and-slots">組件 & Slots</a></h2>組件和 slots 能提供類似于區塊和布局的好處；不過，一些人可能發現組件和 slots 更容易理解。首先，讓我們假設一個會在我們應用中重復使用的「警告」組件:<pre class=" language-php"><code class=" language-php"> <div class="alert alert-danger"> {{ $slot }} </div></code></pre><code class=" language-php">{{ $slot }}</code> 變量將包含我們希望注入到組件的內容。現在，我們可以使用 <code class=" language-php">@component</code> 指令來構造這個組件：<pre class=" language-php"><code class=" language-php">@component('alert') <strong>哇！</strong> 出現了一些問題！ @endcomponent</code></pre>有些時候它對于定義組件的多個 slots 是非常有幫助的。讓我們修改我們的警告組件，讓它支持注入一個「標題」。已命名的 slots 將顯示「相對應」名稱的變量的值:<pre class=" language-php"><code class=" language-php"> <div class="alert alert-danger"> <div class="alert-title">{{ $title }}</div> {{ $slot }} </div></code></pre>現在，我們可以使用 <code class=" language-php">@slot</code> 指令注入內容到已命名的 slot 中，任何沒有被 <code class=" language-php">@slot</code> 指令包裹住的內容將傳遞給組件中的 <code class=" language-php">$slot</code> 變量:<pre class=" language-php"><code class=" language-php">@component('alert') @slot('title') 拒絕 @endslot 你沒有權限訪問這個資源！ @endcomponent</code></pre><h4>傳遞額外的數據給組件</h4>有時候你可能需要傳遞額外的數據給組件。為了解決這個問題，你可以傳遞一個數組作為第二個參數傳遞給 <code class=" language-php">@component</code> 指令。所有的數據都將以變量的形式傳遞給組件模版:<pre class=" language-php"><code class=" language-php">@component('alert', ['foo' => 'bar']) ... @endcomponent</code></pre><a name="displaying-data"></a><h2><a href="#displaying-data">顯示數據</a></h2>你可以使用「中括號」包住變量以顯示傳遞至 Blade 視圖的數據。如下面的路由設置：<pre class=" language-php"><code class=" language-php">Route::get('greeting', function () { return view('welcome', ['name' => 'Samantha']); });</code></pre>你可以像這樣顯示 <code class=" language-php">name</code> 變量的內容：<pre class=" language-php"><code class=" language-php">Hello, {{ $name }}.</code></pre>當然也不是說一定只能顯示傳遞至視圖的變量內容。你也可以顯示 PHP 函數的結果。事實上，你可以在 Blade 中顯示任意的 PHP 代碼：<pre class=" language-php"><code class=" language-php">The current UNIX timestamp is {{ time() }}.</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> Blade <code class=" language-php">{{ }}</code> 語法會自動調用 PHP <code class=" language-php">htmlspecialchars</code> 函數來避免 XSS 攻擊。</blockquote><h4>當數據存在時輸出</h4>有時候你可能想要輸出一個變量，但是你并不確定這個變量是否已經被定義，我們可以用像這樣的冗長 PHP 代碼表達：<pre class=" language-php"><code class=" language-php">{{ isset($name) ? $name : 'Default' }}</code></pre>事實上，Blade 提供了更便捷的方式來代替這種三元運算符表達式：<pre class=" language-php"><code class=" language-php">{{ $name or 'Default' }}</code></pre>在這個例子中，如果 <code class=" language-php">$name</code> 變量存在，它的值將被顯示出來。但是，如果它不存在，則會顯示 <code class=" language-php">Default</code> 。<h4>顯示未轉義過的數據</h4>在默認情況下，Blade 模板中的 <code class=" language-php">{{ }}</code> 表達式將會自動調用 PHP <code class=" language-php">htmlspecialchars</code> 函數來轉義數據以避免 XSS 的攻擊。如果你不想你的數據被轉義，你可以使用下面的語法：<pre class=" language-php"><code class=" language-php">Hello, {!! $name !!}.</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 要非常小心處理用戶輸入的數據時，你應該總是使用 <code class=" language-php">{{ }}</code> 語法來轉義內容中的任何的 HTML 元素，以避免 XSS 攻擊。</blockquote><a name="blade-and-javascript-frameworks"></a><h3>Blade & JavaScript 框架</h3>由于很多 JavaScript 框架都使用花括號來表明所提供的表達式，所以你可以使用 <code class=" language-php">@</code> 符號來告知 Blade 渲染引擎你需要保留這個表達式原始形態，例如：<pre class=" language-php"><code class=" language-php"><h1>Laravel</h1> Hello, @{{ name }}.</code></pre>在這個例子里，<code class=" language-php">@</code> 符號最終會被 Blade 引擎剔除，并且 <code class=" language-php">{{ name }}</code> 表達式會被原樣的保留下來，這樣就允許你的 JavaScript 框架來使用它了。<h4><code class=" language-php">@verbatim</code> 指令</h4>如果你需要在頁面中大片區塊中展示 JavaScript 變量，你可以使用 <code class=" language-php">@verbatim</code> 指令來包裹 HTML 內容，這樣你就不需要為每個需要解析的變量增加 <code class=" language-php">@</code> 符號前綴了：<pre class=" language-php"><code class=" language-php">@verbatim <div class="container"> Hello, {{ name }}. </div> @endverbatim</code></pre><a name="control-structures"></a><h2><a href="#control-structures">控制結構</a></h2>除了模板繼承與數據顯示的功能以外，Blade 也給一般的 PHP 結構控制語句提供了方便的縮寫，比如條件表達式和循環語句。這些縮寫提供了更為清晰簡明的方式來使用 PHP 的控制結構，而且還保持與 PHP 語句的相似性。<a name="if-statements"></a><h3>If 語句</h3>你可以通過 <code class=" language-php">@if</code>, <code class=" language-php">@elseif</code>, <code class=" language-php">@else</code> 及 <code class=" language-php">@endif</code> 指令構建 <code class=" language-php">if</code> 表達式。這些命令的功能等同于在 PHP 中的語法：<pre class=" language-php"><code class=" language-php">@if (count($records) === 1) 我有一條記錄！ @elseif (count($records) > 1) 我有多條記錄！ @else 我沒有任何記錄！ @endif</code></pre>為了方便，Blade 也提供了一個 <code class=" language-php">@unless</code> 命令：<pre class=" language-php"><code class=" language-php">@unless (Auth::check()) 你尚未登錄。 @endunless</code></pre><a name="loops"></a><h3>循環</h3>除了條件表達式外，Blade 也支持 PHP 的循環結構，這些命令的功能等同于在 PHP 中的語法：<pre class=" language-php"><code class=" language-php">@for ($i = 0; $i < 10; $i++) 目前的值為 {{ $i }} @endfor @foreach ($users as $user) <p>此用戶為 {{ $user->id }}</p> @endforeach @forelse ($users as $user) <li>{{ $user->name }}</li> @empty <p>沒有用戶</p> @endforelse @while (true) <p>我永遠都在跑循環。</p> @endwhile</code></pre><blockquote class="has-icon tip"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="56.6px" height="87.5px" viewBox="0 0 56.6 87.5" enable-background="new 0 0 56.6 87.5" xml:space="preserve"><path fill="#FFFFFF" d="M28.7 64.5c-1.4 0-2.5-1.1-2.5-2.5v-5.7 -5V41c0-1.4 1.1-2.5 2.5-2.5s2.5 1.1 2.5 2.5v10.1 5 5.8C31.2 63.4 30.1 64.5 28.7 64.5zM26.4 0.1C11.9 1 0.3 13.1 0 27.7c-0.1 7.9 3 15.2 8.2 20.4 0.5 0.5 0.8 1 1 1.7l3.1 13.1c0.3 1.1 1.3 1.9 2.4 1.9 0.3 0 0.7-0.1 1.1-0.2 1.1-0.5 1.6-1.8 1.4-3l-2-8.4 -0.4-1.8c-0.7-2.9-2-5.7-4-8 -1-1.2-2-2.5-2.7-3.9C5.8 35.3 4.7 30.3 5.4 25 6.7 14.5 15.2 6.3 25.6 5.1c13.9-1.5 25.8 9.4 25.8 23 0 4.1-1.1 7.9-2.9 11.2 -0.8 1.4-1.7 2.7-2.7 3.9 -2 2.3-3.3 5-4 8L41.4 53l-2 8.4c-0.3 1.2 0.3 2.5 1.4 3 0.3 0.2 0.7 0.2 1.1 0.2 1.1 0 2.2-0.8 2.4-1.9l3.1-13.1c0.2-0.6 0.5-1.2 1-1.7 5-5.1 8.2-12.1 8.2-19.8C56.4 12 42.8-1 26.4 0.1zM43.7 69.6c0 0.5-0.1 0.9-0.3 1.3 -0.4 0.8-0.7 1.6-0.9 2.5 -0.7 3-2 8.6-2 8.6 -1.3 3.2-4.4 5.5-7.9 5.5h-4.1H28h-0.5 -3.6c-3.5 0-6.7-2.4-7.9-5.7l-0.1-0.4 -1.8-7.8c-0.4-1.1-0.8-2.1-1.2-3.1 -0.1-0.3-0.2-0.5-0.2-0.9 0.1-1.3 1.3-2.1 2.6-2.1H41C42.4 67.5 43.6 68.2 43.7 69.6zM37.7 72.5H26.9c-4.2 0-7.2 3.9-6.3 7.9 0.6 1.3 1.8 2.1 3.2 2.1h4.1 0.5 0.5 3.6c1.4 0 2.7-0.8 3.2-2.1L37.7 72.5z"></path></svg></div> 當循環時，你可以使用 <a href="#the-loop-variable">循環變量</a> 來獲取循環中有價值的信息，比如循環中的首次或最后的迭代。</blockquote>當使用循環時，你可能也需要一些結束循環或者跳出當前循環的命令：<pre class=" language-php"><code class=" language-php">@foreach ($users as $user) @if ($user->type == 1) @continue @endif <li>{{ $user->name }}</li> @if ($user->number == 5) @break @endif @endforeach</code></pre>你也可以使用命令聲明包含條件的方式在一條語句中達到中斷:<pre class=" language-php"><code class=" language-php">@foreach ($users as $user) @continue($user->type == 1) <li>{{ $user->name }}</li> @break($user->number == 5) @endforeach</code></pre><a name="the-loop-variable"></a><h3>循環變量</h3>當循環時，你可以在循環內訪問 <code class=" language-php">$loop</code> 變量。這個變量可以提供一些有用的信息，比如當前循環的索引，當前循環是不是首次迭代，又或者當前循環是不是最后一次迭代：<pre class=" language-php"><code class=" language-php">@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</code></pre>如果你是在一個嵌套的循環中，你可以通過使用 <code class=" language-php">$loop</code> 變量的 <code class=" language-php">parent</code> 屬性來獲取父循環中的 <code class=" language-php">$loop</code> 變量：<pre class=" language-php"><code class=" language-php">@foreach ($users as $user) @foreach ($user->posts as $post) @if ($loop->parent->first) This is first iteration of the parent loop. @endif @endforeach @endforeach</code></pre><code class=" language-php">$loop</code> 變量也包含了其它各種有用的屬性：<table><thead><tr><th>屬性</th><th>描述</th></tr></thead><tbody><tr><td><code class=" language-php">$loop->index</code></td><td>當前循環所迭代的索引，起始為 0。</td></tr><tr><td><code class=" language-php">$loop->iteration</code></td><td>當前迭代數，起始為 1。</td></tr><tr><td><code class=" language-php">$loop->remaining</code></td><td>循環中迭代剩余的數量。</td></tr><tr><td><code class=" language-php">$loop->count</code></td><td>被迭代項的總數量。</td></tr><tr><td><code class=" language-php">$loop->first</code></td><td>當前迭代是否是循環中的首次迭代。</td></tr><tr><td><code class=" language-php">$loop->last</code></td><td>當前迭代是否是循環中的最后一次迭代。</td></tr><tr><td><code class=" language-php">$loop->depth</code></td><td>當前循環的嵌套深度。</td></tr><tr><td><code class=" language-php">$loop->parent</code></td><td>當在嵌套的循環內時，可以訪問到父循環中的 $loop 變量。</td></tr></tbody></table><a name="comments"></a><h3>注釋</h3>Blade 也允許在頁面中定義注釋，然而，跟 HTML 的注釋不同的是，Blade 注釋不會被包含在應用程序返回的 HTML 內：<pre class=" language-php"><code class=" language-php">{{-- 此注釋將不會出現在渲染后的 HTML --}}</code></pre><a name="php"></a><h3>PHP</h3>在某些情況下，它對于你在視圖文件中嵌入 php 代碼是非常有幫助的。你可以在你的模版中使用 Blade 提供的 <code class=" language-php">@php</code> 指令來執行一段純 PHP 代碼：<pre class=" language-php"><code class=" language-php">@php // @endphp</code></pre><blockquote class="has-icon tip"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="56.6px" height="87.5px" viewBox="0 0 56.6 87.5" enable-background="new 0 0 56.6 87.5" xml:space="preserve"><path fill="#FFFFFF" d="M28.7 64.5c-1.4 0-2.5-1.1-2.5-2.5v-5.7 -5V41c0-1.4 1.1-2.5 2.5-2.5s2.5 1.1 2.5 2.5v10.1 5 5.8C31.2 63.4 30.1 64.5 28.7 64.5zM26.4 0.1C11.9 1 0.3 13.1 0 27.7c-0.1 7.9 3 15.2 8.2 20.4 0.5 0.5 0.8 1 1 1.7l3.1 13.1c0.3 1.1 1.3 1.9 2.4 1.9 0.3 0 0.7-0.1 1.1-0.2 1.1-0.5 1.6-1.8 1.4-3l-2-8.4 -0.4-1.8c-0.7-2.9-2-5.7-4-8 -1-1.2-2-2.5-2.7-3.9C5.8 35.3 4.7 30.3 5.4 25 6.7 14.5 15.2 6.3 25.6 5.1c13.9-1.5 25.8 9.4 25.8 23 0 4.1-1.1 7.9-2.9 11.2 -0.8 1.4-1.7 2.7-2.7 3.9 -2 2.3-3.3 5-4 8L41.4 53l-2 8.4c-0.3 1.2 0.3 2.5 1.4 3 0.3 0.2 0.7 0.2 1.1 0.2 1.1 0 2.2-0.8 2.4-1.9l3.1-13.1c0.2-0.6 0.5-1.2 1-1.7 5-5.1 8.2-12.1 8.2-19.8C56.4 12 42.8-1 26.4 0.1zM43.7 69.6c0 0.5-0.1 0.9-0.3 1.3 -0.4 0.8-0.7 1.6-0.9 2.5 -0.7 3-2 8.6-2 8.6 -1.3 3.2-4.4 5.5-7.9 5.5h-4.1H28h-0.5 -3.6c-3.5 0-6.7-2.4-7.9-5.7l-0.1-0.4 -1.8-7.8c-0.4-1.1-0.8-2.1-1.2-3.1 -0.1-0.3-0.2-0.5-0.2-0.9 0.1-1.3 1.3-2.1 2.6-2.1H41C42.4 67.5 43.6 68.2 43.7 69.6zM37.7 72.5H26.9c-4.2 0-7.2 3.9-6.3 7.9 0.6 1.3 1.8 2.1 3.2 2.1h4.1 0.5 0.5 3.6c1.4 0 2.7-0.8 3.2-2.1L37.7 72.5z"></path></svg></div> 雖然 Blade 提供了這個功能，但頻繁地使用也同時意味著你在你的模版中嵌入了太多的邏輯了。</blockquote><a name="including-sub-views"></a><h2><a href="#including-sub-views">引入子視圖</a></h2>你可以使用 Blade 的 <code class=" language-php">@include</code> 命令來引入一個已存在的視圖，所有在父視圖的可用變量在被引入的視圖中都是可用的。<pre class=" language-php"><code class=" language-php"><div> @include('shared.errors') <form>  </form> </div></code></pre>盡管被引入的視圖會繼承父視圖中的所有數據，你也可以通過傳遞額外的數組數據至被引入的頁面：<pre class=" language-php"><code class=" language-php">@include('view.name', ['some' => 'data'])</code></pre>當然，如果你嘗試使用 <code class=" language-php">@include</code> 去引用一個不存在的視圖，Laravel 會拋出錯誤。如果你想引入一個視圖，而你又無法確認這個視圖存在與否，你可以使用 <code class=" language-php">@includeIf</code> 指令:<pre class=" language-php"><code class=" language-php">@includeIf('view.name', ['some' => 'data'])</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 請避免在 Blade 視圖中使用 <code class=" language-php">__DIR__</code> 及 <code class=" language-php">__FILE__</code> 常量，因為他們會引用視圖被緩存的位置。</blockquote><a name="rendering-views-for-collections"></a><h3>為集合渲染視圖</h3>你可以使用 Blade 的 <code class=" language-php">@each</code> 命令將循環及引入結合成一行代碼：<pre class=" language-php"><code class=" language-php">@each('view.name', $jobs, 'job')</code></pre>第一個參數為每個元素要渲染的子視圖，第二個參數是你要迭代的數組或集合，而第三個參數為迭代時被分配至子視圖中的變量名稱。舉個例子，如果你需要迭代一個 <code class=" language-php">jobs</code> 數組，通常子視圖會使用 <code class=" language-php">job</code> 作為變量來訪問 job 信息。子視圖使用 <code class=" language-php">key</code> 變量作為當前迭代的鍵名。你也可以傳遞第四個參數到 <code class=" language-php">@each</code> 命令。當需要迭代的數組為空時，將會使用這個參數提供的視圖來渲染。<pre class=" language-php"><code class=" language-php">@each('view.name', $jobs, 'job', 'view.empty')</code></pre><a name="stacks"></a><h2><a href="#stacks">堆棧</a></h2>Blade 也允許你在其它視圖或布局中為已經命名的堆棧中壓入數據，這在子視圖中引入必備的 JavaScript 類庫時尤其有用：<pre class=" language-php"><code class=" language-php">@push('scripts') <script src="/example.js"></script> @endpush</code></pre>你可以根據需要多次壓入堆棧，通過 <code class=" language-php">@stack</code> 命令中鍵入堆棧的名字來渲染整個堆棧：<pre class=" language-php"><code class=" language-php"><head>  @stack('scripts') </head></code></pre><a name="service-injection"></a><h2><a href="#service-injection">服務注入</a></h2>你可以使用 <code class=" language-php">@inject</code> 命令來從 Larvel <a href="/docs/5.4/container">service container</a> 中取出服務。傳遞給 <code class=" language-php">@inject</code> 的第一個參數為置放該服務的變量名稱，而第二個參數為你想要解析的服務的類或是接口的名稱：<pre class=" language-php"><code class=" language-php">@inject('metrics', 'App\Services\MetricsService') <div> Monthly Revenue: {{ $metrics->monthlyRevenue() }}. </div></code></pre><a name="extending-blade"></a><h2><a href="#extending-blade">拓展 Blade</a></h2>Blade 甚至允許你使用 <code class=" language-php">directive</code> 方法來注冊自己的命令。當 Blade 編譯器遇到該命令時，它將會帶參數調用提供的回調函數。以下例子會創建一個把指定的 <code class=" language-php">$var</code> 格式化的 <code class=" language-php">@datetime($var)</code> 命令：<pre class=" language-php"><code class=" language-php"><?php namespace App\Providers; use Illuminate\Support\Facades\Blade; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { /** * 運行服務注冊后的啟動進程。 * * @return void */ public function boot() { Blade::directive('datetime', function ($expression) { return "<?php echo ($expression)->format('m/d/Y H:i'); ?>"; }); } /** * 在容器注冊綁定。 * * @return void */ public function register() { // } }</code></pre>如你所見，我們可以使用鏈式調用 <code class=" language-php">format</code> 方法的表述方式傳遞到指令。所以，在這個例子里，最終該指令生成了的 PHP 代碼如下：<pre class=" language-php"><code class=" language-php"><?php echo $var->format('m/d/Y H:i'); ?></code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 在更新 Blade 指令的邏輯后，你將需要刪除所有已緩存的 Blade 視圖，使用 <code class=" language-php">view:clear</code> Artisan 命令來清除被緩存的視圖。</blockquote></article>