輔助函數 · laravel 5.4

<article><h1>Laravel 的輔助函數列表</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#available-methods">可用方法</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>Laravel 包含有各種各樣的 PHP 輔助函數，許多都是在 Laravel 自身框架中使用到。如果你覺得實用，也可以在你自己的應用中使用它們。<a name="available-methods"></a><h2><a href="#available-methods">可用方法</a></h2><style>.collection-method-list > p { column-count: 3; -moz-column-count: 3; -webkit-column-count: 3; column-gap: 2em; -moz-column-gap: 2em; -webkit-column-gap: 2em; } .collection-method-list a { display: block; }</style><h3>數組</h3><div class="collection-method-list"><a href="#method-array-add">array_add</a> <a href="#method-array-collapse">array_collapse</a> <a href="#method-array-divide">array_divide</a> <a href="#method-array-dot">array_dot</a> <a href="#method-array-except">array_except</a> <a href="#method-array-first">array_first</a> <a href="#method-array-flatten">array_flatten</a> <a href="#method-array-forget">array_forget</a> <a href="#method-array-get">array_get</a> <a href="#method-array-has">array_has</a> <a href="#method-array-last">array_last</a> <a href="#method-array-only">array_only</a> <a href="#method-array-pluck">array_pluck</a> <a href="#method-array-prepend">array_prepend</a> <a href="#method-array-pull">array_pull</a> <a href="#method-array-set">array_set</a> <a href="#method-array-sort">array_sort</a> <a href="#method-array-sort-recursive">array_sort_recursive</a> <a href="#method-array-where">array_where</a> <a href="#method-head">head</a> <a href="#method-last">last</a></div><h3>路徑</h3><div class="collection-method-list"><a href="#method-app-path">app_path</a> <a href="#method-base-path">base_path</a> <a href="#method-config-path">config_path</a> <a href="#method-database-path">database_path</a> <a href="#method-mix">mix</a> <a href="#method-public-path">public_path</a> <a href="#method-resource-path">resource_path</a> <a href="#method-storage-path">storage_path</a></div><h3>字符串</h3><div class="collection-method-list"><a href="#method-camel-case">camel_case</a> <a href="#method-class-basename">class_basename</a> <a href="#method-e">e</a> <a href="#method-ends-with">ends_with</a> <a href="#method-snake-case">snake_case</a> <a href="#method-str-limit">str_limit</a> <a href="#method-starts-with">starts_with</a> <a href="#method-str-contains">str_contains</a> <a href="#method-str-finish">str_finish</a> <a href="#method-str-is">str_is</a> <a href="#method-str-plural">str_plural</a> <a href="#method-str-random">str_random</a> <a href="#method-str-singular">str_singular</a> <a href="#method-str-slug">str_slug</a> <a href="#method-studly-case">studly_case</a> <a href="#method-title-case">title_case</a> <a href="#method-trans">trans</a> <a href="#method-trans-choice">trans_choice</a></div><h3>URLs</h3><div class="collection-method-list"><a href="#method-action">action</a> <a href="#method-asset">asset</a> <a href="#method-secure-asset">secure_asset</a> <a href="#method-secure-url">secure_url</a> <a href="#method-route">route</a> <a href="#method-url">url</a></div><h3>其他</h3><div class="collection-method-list"><a href="#method-abort">abort</a> <a href="#method-abort-if">abort_if</a> <a href="#method-abort-unless">abort_unless</a> <a href="#method-auth">auth</a> <a href="#method-back">back</a> <a href="#method-bcrypt">bcrypt</a> <a href="#method-cache">cache</a> <a href="#method-collect">collect</a> <a href="#method-config">config</a> <a href="#method-csrf-field">csrf_field</a> <a href="#method-csrf-token">csrf_token</a> <a href="#method-dd">dd</a> <a href="#method-dispatch">dispatch</a> <a href="#method-env">env</a> <a href="#method-event">event</a> <a href="#method-factory">factory</a> <a href="#method-info">info</a> <a href="#method-logger">logger</a> <a href="#method-method-field">method_field</a> <a href="#method-old">old</a> <a href="#method-redirect">redirect</a> <a href="#method-request">request</a> <a href="#method-response">response</a> <a href="#method-retry">retry</a> <a href="#method-session">session</a> <a href="#method-value">value</a> <a href="#method-view">view</a></div><a name="method-listing"></a><h2><a href="#method-listing">方法列表</a></h2><style>#collection-method code { font-size: 14px; } #collection-method:not(.first-collection-method) { margin-top: 50px; }</style><a name="arrays"></a><h2><a href="#arrays">數組</a></h2><a name="method-array-add"></a><h4 id="collection-method" class="first-collection-method"><code class=" language-php">array_add()</code></h4>如果給定的鍵不存在與數組中，<code class=" language-php">array_add</code> 就會把給定的鍵值對添加到數組中：<pre class=" language-php"><code class=" language-php">$array = array_add(['name' => 'Desk'], 'price', 100); // ['name' => 'Desk', 'price' => 100]</code></pre><a name="method-array-collapse"></a><h4 id="collection-method"><code class=" language-php">array_collapse()</code></h4><code class=" language-php">array_collapse</code> 函數把數組里的每一個數組合并成單個數組：<pre class=" language-php"><code class=" language-php">$array = array_collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]); // [1, 2, 3, 4, 5, 6, 7, 8, 9]</code></pre><a name="method-array-divide"></a><h4 id="collection-method"><code class=" language-php">array_divide()</code></h4><code class=" language-php">array_divide</code> 函數返回兩個數組，一個包含原本數組的鍵，另一個包含原本數組的值：<pre class=" language-php"><code class=" language-php">list($keys, $values) = array_divide(['name' => 'Desk']); // $keys: ['name'] // $values: ['Desk']</code></pre><a name="method-array-dot"></a><h4 id="collection-method"><code class=" language-php">array_dot()</code></h4><code class=" language-php">array_dot</code> 函數把多維數組壓制成一維數組，并用「點」式語法表示深度：<pre class=" language-php"><code class=" language-php">$array = array_dot(['foo' => ['bar' => 'baz']]); // ['foo.bar' => 'baz'];</code></pre><a name="method-array-except"></a><h4 id="collection-method"><code class=" language-php">array_except()</code></h4><code class=" language-php">array_except</code> 函數從數組移除指定的鍵值對：<pre class=" language-php"><code class=" language-php">$array = ['name' => 'Desk', 'price' => 100]; $array = array_except($array, ['price']); // ['name' => 'Desk']</code></pre><a name="method-array-first"></a><h4 id="collection-method"><code class=" language-php">array_first()</code></h4><code class=" language-php">array_first</code> 函數返回數組中第一個通過指定測試的元素：<pre class=" language-php"><code class=" language-php">$array = [100, 200, 300]; $value = array_first($array, function ($value, $key) { return $value >= 150; }); // 200</code></pre>可傳遞第三個參數作為默認值。當沒有元素通過測試時，將會返回該默認值：<pre class=" language-php"><code class=" language-php">$value = array_first($array, $callback, $default);</code></pre><a name="method-array-flatten"></a><h4 id="collection-method"><code class=" language-php">array_flatten()</code></h4><code class=" language-php">array_flatten</code> 函數將多維數組壓制成一維數組：<pre class=" language-php"><code class=" language-php">$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']]; $array = array_flatten($array); // ['Joe', 'PHP', 'Ruby'];</code></pre><a name="method-array-forget"></a><h4 id="collection-method"><code class=" language-php">array_forget()</code></h4><code class=" language-php">array_forget</code> 函數以「點」式語法從深度嵌套的數組中移除指定的鍵值對：<pre class=" language-php"><code class=" language-php">$array = ['products' => ['desk' => ['price' => 100]]]; array_forget($array, 'products.desk'); // ['products' => []]</code></pre><a name="method-array-get"></a><h4 id="collection-method"><code class=" language-php">array_get()</code></h4><code class=" language-php">array_get</code> 函數使用「點」式語法從深度嵌套的數組中獲取指定的值：<pre class=" language-php"><code class=" language-php">$array = ['products' => ['desk' => ['price' => 100]]]; $value = array_get($array, 'products.desk'); // ['price' => 100]</code></pre><code class=" language-php">array_get</code> 函數同樣也接受默認值，如果指定的鍵找不到時，則返回該默認值：<pre class=" language-php"><code class=" language-php">$value = array_get($array, 'names.john', 'default');</code></pre><a name="method-array-has"></a><h4 id="collection-method"><code class=" language-php">array_has()</code></h4><code class=" language-php">array_has</code> 函數使用「點」式語法檢查指定的項目是否存在于數組中：<pre class=" language-php"><code class=" language-php">$array = ['product' => ['name' => 'desk', 'price' => 100]]; $hasItem = array_has($array, 'product.name'); // true $hasItems = array_has($array, ['product.price', 'product.discount']); // false</code></pre><a name="method-array-last"></a><h4 id="collection-method"><code class=" language-php">array_last()</code></h4><code class=" language-php">array_last</code> 函數返回數組中最后一個通過指定測試的元素：<pre class=" language-php"><code class=" language-php">$array = [100, 200, 300, 110]; $value = array_last($array, function ($value, $key) { return $value >= 150; }); // 300</code></pre><a name="method-array-only"></a><h4 id="collection-method"><code class=" language-php">array_only()</code></h4><code class=" language-php">array_only</code> 函數從數組返回指定的鍵值對：<pre class=" language-php"><code class=" language-php">$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10]; $array = array_only($array, ['name', 'price']); // ['name' => 'Desk', 'price' => 100]</code></pre><a name="method-array-pluck"></a><h4 id="collection-method"><code class=" language-php">array_pluck()</code></h4><code class=" language-php">array_pluck</code> 函數從數組拉出一列指定的鍵值對：<pre class=" language-php"><code class=" language-php">$array = [ ['developer' => ['id' => 1, 'name' => 'Taylor']], ['developer' => ['id' => 2, 'name' => 'Abigail']], ]; $array = array_pluck($array, 'developer.name'); // ['Taylor', 'Abigail'];</code></pre>你也可以指定要以什么作為結果列的鍵名：<pre class=" language-php"><code class=" language-php">$array = array_pluck($array, 'developer.name', 'developer.id'); // [1 => 'Taylor', 2 => 'Abigail'];</code></pre><a name="method-array-prepend"></a><h4 id="collection-method"><code class=" language-php">array_prepend()</code></h4><code class=" language-php">array_prepend</code> 函數將元素加到數組的頭部：<pre class=" language-php"><code class=" language-php">$array = ['one', 'two', 'three', 'four']; $array = array_prepend($array, 'zero'); // $array: ['zero', 'one', 'two', 'three', 'four']</code></pre><a name="method-array-pull"></a><h4 id="collection-method"><code class=" language-php">array_pull()</code></h4><code class=" language-php">array_pull</code> 函數從數組移除指定鍵值對并返回該鍵值對：<pre class=" language-php"><code class=" language-php">$array = ['name' => 'Desk', 'price' => 100]; $name = array_pull($array, 'name'); // $name: Desk // $array: ['price' => 100]</code></pre><a name="method-array-set"></a><h4 id="collection-method"><code class=" language-php">array_set()</code></h4><code class=" language-php">array_set</code> 函數使用「點」式語法在深度嵌套的數組中寫入值：<pre class=" language-php"><code class=" language-php">$array = ['products' => ['desk' => ['price' => 100]]]; array_set($array, 'products.desk.price', 200); // ['products' => ['desk' => ['price' => 200]]]</code></pre><a name="method-array-sort"></a><h4 id="collection-method"><code class=" language-php">array_sort()</code></h4><code class=" language-php">array_sort</code> 函數根據指定閉包的結果排序數組：<pre class=" language-php"><code class=" language-php">$array = [ ['name' => 'Desk'], ['name' => 'Chair'], ]; $array = array_values(array_sort($array, function ($value) { return $value['name']; })); /* [ ['name' => 'Chair'], ['name' => 'Desk'], ] */</code></pre><a name="method-array-sort-recursive"></a><h4 id="collection-method"><code class=" language-php">array_sort_recursive()</code></h4><code class=" language-php">array_sort_recursive</code> 函數使用 sort 函數遞歸排序數組：<pre class=" language-php"><code class=" language-php">$array = [ [ 'Roman', 'Taylor', 'Li', ], [ 'PHP', 'Ruby', 'JavaScript', ], ]; $array = array_sort_recursive($array); /* [ [ 'Li', 'Roman', 'Taylor', ], [ 'JavaScript', 'PHP', 'Ruby', ] ]; */</code></pre><a name="method-array-where"></a><h4 id="collection-method"><code class=" language-php">array_where()</code></h4><code class=" language-php">array_where</code> 函數使用指定的閉包過濾數組：<pre class=" language-php"><code class=" language-php">$array = [100, '200', 300, '400', 500]; $array = array_where($array, function ($value, $key) { return is_string($value); }); // [1 => 200, 3 => 400]</code></pre><a name="method-head"></a><h4 id="collection-method"><code class=" language-php">head()</code></h4><code class=" language-php">head</code> 函數返回指定數組的第一個元素：<pre class=" language-php"><code class=" language-php">$array = [100, 200, 300]; $first = head($array); // 100</code></pre><a name="method-last"></a><h4 id="collection-method"><code class=" language-php">last()</code></h4><code class=" language-php">last</code> 函數返回指定數組的最后一個元素：<pre class=" language-php"><code class=" language-php">$array = [100, 200, 300]; $last = last($array); // 300</code></pre><a name="paths"></a><h2><a href="#paths">路徑</a></h2><a name="method-app-path"></a><h4 id="collection-method"><code class=" language-php">app_path()</code></h4><code class=" language-php">app_path</code> 函數返回 <code class=" language-php">app</code> 文件夾的完整路徑。你也可以使用 <code class=" language-php">app_path</code> 函數生成針對指定文件相對于 app 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = app_path(); $path = app_path('Http/Controllers/Controller.php');</code></pre><a name="method-base-path"></a><h4 id="collection-method"><code class=" language-php">base_path()</code></h4><code class=" language-php">base_path</code> 函數返回項目根目錄的完整路徑。你也可以使用 <code class=" language-php">base_path</code> 函數生成針對指定文件相對于項目根目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = base_path(); $path = base_path('vendor/bin');</code></pre><a name="method-config-path"></a><h4 id="collection-method"><code class=" language-php">config_path()</code></h4><code class=" language-php">config_path</code> 函數返回 <code class=" language-php">config</code> 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = config_path();</code></pre><a name="method-database-path"></a><h4 id="collection-method"><code class=" language-php">database_path()</code></h4><code class=" language-php">database_path</code> 函數返回 <code class=" language-php">database</code> 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = database_path();</code></pre><a name="method-mix"></a><h4 id="collection-method"><code class=" language-php">mix()</code></h4><code class=" language-php">mix</code> 函數獲取帶有版本號的 <a href="/docs/5.4/mix">mix</a> 文件:<pre class=" language-php"><code class=" language-php">mix($file);</code></pre><a name="method-public-path"></a><h4 id="collection-method"><code class=" language-php">public_path()</code></h4><code class=" language-php">public_path</code> 函數返回 <code class=" language-php">public</code> 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = public_path();</code></pre><a name="method-resource-path"></a><h4 id="collection-method"><code class=" language-php">resource_path()</code></h4><code class=" language-php">resource_path</code> 函數返回 <code class=" language-php">resources</code> 目錄的完整路徑。你也可以使用 <code class=" language-php">resource_path</code> 函數生成針對指定文件相對于 <code class=" language-php">resources</code> 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = resource_path(); $path = resource_path('assets/sass/app.scss');</code></pre><a name="method-storage-path"></a><h4 id="collection-method"><code class=" language-php">storage_path()</code></h4><code class=" language-php">storage_path</code> 函數返回 <code class=" language-php">storage</code> 目錄的完整路徑。你也可以使用 <code class=" language-php">storage_path</code> 函數生成針對指定文件相對于 <code class=" language-php">storage</code> 目錄的完整路徑：<pre class=" language-php"><code class=" language-php">$path = storage_path(); $path = storage_path('app/file.txt');</code></pre><a name="strings"></a><h2><a href="#strings">字符串</a></h2><a name="method-camel-case"></a><h4 id="collection-method"><code class=" language-php">camel_case()</code></h4><code class=" language-php">camel_case</code> 函數將指定的字符串轉換成 <code class=" language-php">駝峰式命名</code>：<pre class=" language-php"><code class=" language-php">$camel = camel_case('foo_bar'); // fooBar</code></pre><a name="method-class-basename"></a><h4 id="collection-method"><code class=" language-php">class_basename()</code></h4><code class=" language-php">class_basename</code> 函數返回不包含命名空間的類名稱：<pre class=" language-php"><code class=" language-php">$class = class_basename('Foo\Bar\Baz'); // Baz</code></pre><a name="method-e"></a><h4 id="collection-method"><code class=" language-php">e()</code></h4><code class=" language-php">e</code> 函數對指定字符串進行 <code class=" language-php">htmlentities</code>：<pre class=" language-php"><code class=" language-php">echo e('<html>foo</html>'); // &lt;html&gt;foo&lt;/html&gt;</code></pre><a name="method-ends-with"></a><h4 id="collection-method"><code class=" language-php">ends_with()</code></h4><code class=" language-php">ends_with</code> 函數判斷指定字符串結尾是否為指定內容：<pre class=" language-php"><code class=" language-php">$value = ends_with('This is my name', 'name'); // true</code></pre><a name="method-snake-case"></a><h4 id="collection-method"><code class=" language-php">snake_case()</code></h4><code class=" language-php">snake_case</code> 函數將指定的字符串轉換成 <code class=" language-php">蛇形命名</code> ：<pre class=" language-php"><code class=" language-php">$snake = snake_case('fooBar'); // foo_bar</code></pre><a name="method-str-limit"></a><h4 id="collection-method"><code class=" language-php">str_limit()</code></h4><code class=" language-php">str_limit</code> 函數限制字符串的字符個數，該函數接受一個字符串作為第一個參數，第二個參數為允許的最大字符個數：<pre class=" language-php"><code class=" language-php">$value = str_limit('The PHP framework for web artisans.', 7); // The PHP...</code></pre><a name="method-starts-with"></a><h4 id="collection-method"><code class=" language-php">starts_with()</code></h4><code class=" language-php">starts_with</code> 函數判斷字符串開頭是否為指定內容：<pre class=" language-php"><code class=" language-php">$value = starts_with('This is my name', 'This'); // true</code></pre><a name="method-str-contains"></a><h4 id="collection-method"><code class=" language-php">str_contains()</code></h4><code class=" language-php">str_contains</code> 函數判斷字符串是否包含有指定內容：<pre class=" language-php"><code class=" language-php">$value = str_contains('This is my name', 'my'); // true</code></pre>你也可以傳遞數組，來判斷字符串是否包任意指定內容:<pre class=" language-php"><code class=" language-php">$value = str_contains('This is my name', ['my', 'foo']); // true</code></pre><a name="method-str-finish"></a><h4 id="collection-method"><code class=" language-php">str_finish()</code></h4><code class=" language-php">str_finish</code> 函數添加指定內容到字符串末尾：<pre class=" language-php"><code class=" language-php">$string = str_finish('this/string', '/'); // this/string/</code></pre><a name="method-str-is"></a><h4 id="collection-method"><code class=" language-php">str_is()</code></h4><code class=" language-php">str_is</code> 函數判斷指定的字符串是否匹配指定的格式，星號可作為通配符使用：<pre class=" language-php"><code class=" language-php">$value = str_is('foo*', 'foobar'); // true $value = str_is('baz*', 'foobar'); // false</code></pre><a name="method-str-plural"></a><h4 id="collection-method"><code class=" language-php">str_plural()</code></h4><code class=" language-php">str_plural</code> 函數把字符串轉換成復數形式。該函數目前只支持英文：<pre class=" language-php"><code class=" language-php">$plural = str_plural('car'); // cars $plural = str_plural('child'); // children</code></pre>你可以傳入一個整數作為第二個參數，來獲取字符串的單數或復數形式：<pre class=" language-php"><code class=" language-php">$plural = str_plural('child', 2); // children $plural = str_plural('child', 1); // child</code></pre><a name="method-str-random"></a><h4 id="collection-method"><code class=" language-php">str_random()</code></h4><code class=" language-php">str_random</code> 函數生成指定長度的隨機字符串。該函數使用了 PHP 自帶的 <code class=" language-php">random_bytes</code> 函數：<pre class=" language-php"><code class=" language-php">$string = str_random(40);</code></pre><a name="method-str-singular"></a><h4 id="collection-method"><code class=" language-php">str_singular()</code></h4><code class=" language-php">str_singular</code> 函數把字符串轉換成單數形式。該函數目前只支持英文：<pre class=" language-php"><code class=" language-php">$singular = str_singular('cars'); // car</code></pre><a name="method-str-slug"></a><h4 id="collection-method"><code class=" language-php">str_slug()</code></h4><code class=" language-php">str_slug</code> 函數根據指定字符串生成 URL 友好的「slug」：<pre class=" language-php"><code class=" language-php">$title = str_slug('Laravel 5 Framework', '-'); // laravel-5-framework</code></pre><a name="method-studly-case"></a><h4 id="collection-method"><code class=" language-php">studly_case()</code></h4><code class=" language-php">studly_case</code> 函數把指定字符串轉換成 <code class=" language-php">首字母大寫</code>：<pre class=" language-php"><code class=" language-php">$value = studly_case('foo_bar'); // FooBar</code></pre><a name="method-title-case"></a><h4 id="collection-method"><code class=" language-php">title_case()</code></h4><code class=" language-php">title_case</code> 函數把指定字符串轉換成 <code class=" language-php">每個單詞首字母大寫</code>：<pre class=" language-php"><code class=" language-php">$title = title_case('a nice title uses the correct case'); // A Nice Title Uses The Correct Case</code></pre><a name="method-trans"></a><h4 id="collection-method"><code class=" language-php">trans()</code></h4><code class=" language-php">trans</code> 函數根據你的 <a href="/docs/5.4/localization">本地化文件</a> 翻譯指定的語句：<pre class=" language-php"><code class=" language-php">echo trans('validation.required'):</code></pre><a name="method-trans-choice"></a><h4 id="collection-method"><code class=" language-php">trans_choice()</code></h4><code class=" language-php">trans_choice</code> 函數根據給定數量來決定翻譯指定語句是復數形式還是單數形式：<pre class=" language-php"><code class=" language-php">$value = trans_choice('foo.bar', $count);</code></pre><a name="urls"></a><h2><a href="#urls">URLs</a></h2><a name="method-action"></a><h4 id="collection-method"><code class=" language-php">action()</code></h4><code class=" language-php">action</code> 函數根據指定控制器的方法生成 URL，你不需要傳入該控制器的完整命名空間。只需要傳入相對于 <code class=" language-php">App\Http\Controllers</code> 命名空間的控制器類名：<pre class=" language-php"><code class=" language-php">$url = action('HomeController@getIndex');</code></pre>如果該方法接受路由參數，可以作為第二個參數傳入：<pre class=" language-php"><code class=" language-php">$url = action('UserController@profile', ['id' => 1]);</code></pre><a name="method-asset"></a><h4 id="collection-method"><code class=" language-php">asset()</code></h4>根據當前請求的協議（HTTP 或 HTTPS）生成資源文件的 URL：<pre class=" language-php"><code class=" language-php">$url = asset('img/photo.jpg');</code></pre><a name="method-secure-asset"></a><h4 id="collection-method"><code class=" language-php">secure_asset()</code></h4>使用 HTTPS 協議生成資源文件的 URL：<pre class=" language-php"><code class=" language-php">echo secure_asset('foo/bar.zip', $title, $attributes = []);</code></pre><a name="method-route"></a><h4 id="collection-method"><code class=" language-php">route()</code></h4><code class=" language-php">route</code> 函數生成指定路由名稱的 URL：<pre class=" language-php"><code class=" language-php">$url = route('routeName');</code></pre>如果該路由接受參數，可以作為第二個參數傳入：<pre class=" language-php"><code class=" language-php">$url = route('routeName', ['id' => 1]);</code></pre><a name="method-secure-url"></a><h4 id="collection-method"><code class=" language-php">secure_url()</code></h4><code class=" language-php">secure_url</code> 數使用 HTTPS 協議生成指定路徑的完整 URL：<pre class=" language-php"><code class=" language-php">echo secure_url('user/profile'); echo secure_url('user/profile', [1]);</code></pre><a name="method-url"></a><h4 id="collection-method"><code class=" language-php">url()</code></h4><code class=" language-php">url</code> 函數生成指定路徑的完整 URL：<pre class=" language-php"><code class=" language-php">echo url('user/profile'); echo url('user/profile', [1]);</code></pre>如果沒有提供路徑參數，將會返回一個 <code class=" language-php">Illuminate\Routing\UrlGenerator</code> 實例：<pre class=" language-php"><code class=" language-php">echo url()->current(); echo url()->full(); echo url()->previous();</code></pre><a name="miscellaneous"></a><h2><a href="#miscellaneous">其他</a></h2><a name="method-abort"></a><h4 id="collection-method"><code class=" language-php">abort()</code></h4><code class=" language-php">abort</code> 函數拋出一個將被異常處理句柄渲染的 HTTP 異常：<pre class=" language-php"><code class=" language-php">abort(401);</code></pre>你也可以傳入異常的響應消息：<pre class=" language-php"><code class=" language-php">abort(401, 'Unauthorized.');</code></pre><a name="method-abort-if"></a><h4 id="collection-method"><code class=" language-php">abort_if()</code></h4><code class=" language-php">abort_if</code> 函數如果指定的布爾表達式值為 <code class=" language-php">true</code> 則拋出一個 HTTP 異常：<pre class=" language-php"><code class=" language-php">abort_if(! Auth::user()->isAdmin(), 403);</code></pre><a name="method-abort-unless"></a><h4 id="collection-method"><code class=" language-php">abort_unless()</code></h4><code class=" language-php">abort_unless</code> 函數如果指定的布爾表達式值為 <code class=" language-php">false</code> 則拋出一個 HTTP 異常：<pre class=" language-php"><code class=" language-php">abort_unless(Auth::user()->isAdmin(), 403);</code></pre><a name="method-auth"></a><h4 id="collection-method"><code class=" language-php">auth()</code></h4><code class=" language-php">auth</code> 函數返回一個 authenticator 實例，可以使用它來代替 Auth facade：<pre class=" language-php"><code class=" language-php">$user = auth()->user();</code></pre><a name="method-back"></a><h4 id="collection-method"><code class=" language-php">back()</code></h4><code class=" language-php">back()</code> 函數生成一個重定向響應讓用戶返回到之前的位置：<pre class=" language-php"><code class=" language-php">return back();</code></pre><a name="method-bcrypt"></a><h4 id="collection-method"><code class=" language-php">bcrypt()</code></h4><code class=" language-php">bcrypt</code> 函數使用 Bcrypt 算法哈希指定的數值。你可以使用它代替 <code class=" language-php">Hash</code> facade：<pre class=" language-php"><code class=" language-php">$password = bcrypt('my-secret-password');</code></pre><a name="method-cache"></a><h4 id="collection-method"><code class=" language-php">cache()</code></h4><code class=" language-php">cache</code> 函數嘗試從緩存獲取給定 <code class=" language-php">key</code> 的值。如果 <code class=" language-php">key</code> 不存在則返回默認值：<pre class=" language-php"><code class=" language-php">$value = cache('key'); $value = cache('key', 'default');</code></pre>同時，你也可以傳遞鍵值對來設置緩存，第二個參數可以指定緩存的過期時間，單位分鐘：<pre class=" language-php"><code class=" language-php">cache(['key' => 'value'], 5); cache(['key' => 'value'], Carbon::now()->addSeconds(10));</code></pre><a name="method-collect"></a><h4 id="collection-method"><code class=" language-php">collect()</code></h4><code class=" language-php">collect</code> 函數根據指定的數組生成 <a href="/docs/5.4/collections">集合</a> 實例：<pre class=" language-php"><code class=" language-php">$collection = collect(['taylor', 'abigail']);</code></pre><a name="method-config"></a><h4 id="collection-method"><code class=" language-php">config()</code></h4><code class=" language-php">config</code> 函數用于獲取配置信息的值，配置信息的值可通過「點」式語法訪問，其中包含要訪問的文件名以及選項名。可傳遞一個默認值作為第二參數，當配置信息不存在時，則返回該默認值：<pre class=" language-php"><code class=" language-php">$value = config('app.timezone'); $value = config('app.timezone', $default);</code></pre><code class=" language-php">config</code> 輔助函數也可以在運行期間，根據指定的鍵值對設置指定的配置信息：<pre class=" language-php"><code class=" language-php">config(['app.debug' => true]);</code></pre><a name="method-csrf-field"></a><h4 id="collection-method"><code class=" language-php">csrf_field()</code></h4><code class=" language-php">csrf_field</code> 函數生成包含 CSRF 令牌內容的 HTML 表單隱藏字段。例如，使用 <a href="/docs/5.4/blade">Blade 語法</a>：<pre class=" language-php"><code class=" language-php">{{ csrf_field() }}</code></pre><a name="method-csrf-token"></a><h4 id="collection-method"><code class=" language-php">csrf_token()</code></h4><code class=" language-php">csrf_token</code> 函數獲取當前 CSRF 令牌的內容：<pre class=" language-php"><code class=" language-php">$token = csrf_token();</code></pre><a name="method-dd"></a><h4 id="collection-method"><code class=" language-php">dd()</code></h4><code class=" language-php">dd</code> 函數輸出指定變量的值并終止腳本運行：<pre class=" language-php"><code class=" language-php">dd($value); dd($value1, $value2, $value3, ...);</code></pre>如果你不想終止腳本運行，使用 <code class=" language-php">dump</code> 函數代替：<pre class=" language-php"><code class=" language-php">dump($value);</code></pre><a name="method-dispatch"></a><h4 id="collection-method"><code class=" language-php">dispatch()</code></h4><code class=" language-php">dispatch</code> 函數把一個新任務推送到 Laravel 的 <a href="/docs/5.4/queues">任務隊列</a>中：<pre class=" language-php"><code class=" language-php">dispatch(new App\Jobs\SendEmails);</code></pre><a name="method-env"></a><h4 id="collection-method"><code class=" language-php">env()</code></h4><code class=" language-php">env</code> 函數獲取環境變量值或返回默認值：<pre class=" language-php"><code class=" language-php">$env = env('APP_ENV'); // Return a default value if the variable doesn't exist... $env = env('APP_ENV', 'production');</code></pre><a name="method-event"></a><h4 id="collection-method"><code class=" language-php">event()</code></h4><code class=" language-php">event</code> 函數派發指定的 <a href="/docs/5.4/events">事件</a> 到所屬的偵聽器：<pre class=" language-php"><code class=" language-php">event(new UserRegistered($user));</code></pre><a name="method-factory"></a><h4 id="collection-method"><code class=" language-php">factory()</code></h4><code class=" language-php">factory</code> 函數根據指定類、名稱以及數量生成模型工廠構造器（model factory builder）。可用于 <a href="/docs/5.4/database-testing#writing-factories">測試</a> 或 <a href="/docs/5.4/seeding#using-model-factories">數據填充</a>：<pre class=" language-php"><code class=" language-php">$user = factory(App\User::class)->make();</code></pre><a name="method-info"></a><h4 id="collection-method"><code class=" language-php">info()</code></h4><code class=" language-php">info</code> 函數以 <code class=" language-php">info</code> 級別寫入日志:<pre class=" language-php"><code class=" language-php">info('Some helpful information!');</code></pre>包含上下文數據的數組可以通過第二個參數傳遞給函數：<pre class=" language-php"><code class=" language-php">info('User login attempt failed.', ['id' => $user->id]);</code></pre><a name="method-logger"></a><h4 id="collection-method"><code class=" language-php">logger()</code></h4><code class=" language-php">logger</code> 函數以 <code class=" language-php">debug</code> 級別寫入日志:<pre class=" language-php"><code class=" language-php">logger('Debug message');</code></pre>同時支持傳入數組作為參數：<pre class=" language-php"><code class=" language-php">logger('User has logged in.', ['id' => $user->id]);</code></pre>如果沒有傳入參數，則會返回一個 <a href="/docs/5.4/errors#logging">日志</a> 的實例：<pre class=" language-php"><code class=" language-php">logger()->error('You are not allowed here.');</code></pre><a name="method-method-field"></a><h4 id="collection-method"><code class=" language-php">method_field()</code></h4><code class=" language-php">method_field</code> 函數生成模擬各種 HTTP 動作請求的 HTML 表單隱藏字段。例如，使用 <a href="/docs/5.4/blade">Blade 語法</a>：<pre class=" language-php"><code class=" language-php"><form method="POST"> {{ method_field('DELETE') }} </form></code></pre><a name="method-old"></a><h4 id="collection-method"><code class=" language-php">old()</code></h4><code class=" language-php">old</code> 函數 <a href="/docs/5.4/requests#retrieving-input">獲取</a> session 內一次性的歷史輸入值：<pre class=" language-php"><code class=" language-php">$value = old('value'); $value = old('value', 'default');</code></pre><a name="method-redirect"></a><h4 id="collection-method"><code class=" language-php">redirect()</code></h4><code class=" language-php">redirect</code> 函數返回一個 HTTP 重定向響應，如果調用時沒有傳入參數則返回 redirector 實例：<pre class=" language-php"><code class=" language-php">return redirect('/home'); return redirect()->route('route.name');</code></pre><a name="method-request"></a><h4 id="collection-method"><code class=" language-php">request()</code></h4><code class=" language-php">request</code> 函數返回當前 <a href="/docs/5.4/requests">請求</a> 實例或獲取輸入的項目：<pre class=" language-php"><code class=" language-php">$request = request(); $value = request('key', $default = null)</code></pre><a name="method-response"></a><h4 id="collection-method"><code class=" language-php">response()</code></h4><code class=" language-php">response</code> 函數創建一個 <a href="/docs/5.4/responses">響應</a> 實例或獲取一個 response 工廠實例：<pre class=" language-php"><code class=" language-php">return response('Hello World', 200, $headers); return response()->json(['foo' => 'bar'], 200, $headers);</code></pre><a name="method-retry"></a><h4 id="collection-method"><code class=" language-php">retry()</code></h4><code class=" language-php">retry</code> 函數將會重復調用給定的回調函數，最多調用指定的次數。如果回調函數沒有拋出異常并且有值返回，則 <code class=" language-php">retry</code> 函數返回該值。如果回調函數拋出異常，<code class=" language-php">retry</code> 函數將攔截異常并自動再次調用回調函數，直到調用給定的次數。如果重試次數超出給定次數，攔截的異常將會拋出：<pre class=" language-php"><code class=" language-php">return retry(5, function () { // Attempt 5 times while resting 100ms in between attempts... }, 100);</code></pre><a name="method-session"></a><h4 id="collection-method"><code class=" language-php">session()</code></h4><code class=" language-php">session</code> 函數可用于獲取或設置單個 session 項：<pre class=" language-php"><code class=" language-php">$value = session('key');</code></pre>你可以通過傳遞鍵值對數組給該函數設置 session 項：<pre class=" language-php"><code class=" language-php">session(['chairs' => 7, 'instruments' => 3]);</code></pre>該函數在沒有傳遞參數時，將返回 session 實例：<pre class=" language-php"><code class=" language-php">$value = session()->get('key'); session()->put('key', $value);</code></pre><a name="method-value"></a><h4 id="collection-method"><code class=" language-php">value()</code></h4><code class=" language-php">value</code> 函數返回指定數值。而當你傳遞一個 <code class=" language-php">閉包</code> 給該函數時，該 <code class=" language-php">閉包</code> 將被運行并返回該 <code class=" language-php">閉包</code> 的運行結果：<pre class=" language-php"><code class=" language-php">$value = value(function() { return 'bar'; });</code></pre><a name="method-view"></a><h4 id="collection-method"><code class=" language-php">view()</code></h4><code class=" language-php">view</code> 函數獲取 <a href="/docs/5.4/views">視圖</a> 實例：<pre class=" language-php"><code class=" language-php">return view('auth.login');</code></pre><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://github.com/cmzz">@zyxcba</a></td><td><img class="avatar-66 rm-style" src="https://avatars3.githubusercontent.com/u/6111715?v=3&s=100"></td><td>翻譯</td><td><a href="http://pigtk.com">小豬淘客</a> - 免費的淘寶客優惠券CMS</td></tr></tbody></table></article>