辅助函数 · 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>