<ruby id="bdb3f"></ruby>

    <p id="bdb3f"><cite id="bdb3f"></cite></p>

      <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
        <p id="bdb3f"><cite id="bdb3f"></cite></p>

          <pre id="bdb3f"></pre>
          <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

          <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
          <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

          <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                <ruby id="bdb3f"></ruby>

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

                  <p id="bdb3f"><cite id="bdb3f"></cite></p>

                    <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
                      <p id="bdb3f"><cite id="bdb3f"></cite></p>

                        <pre id="bdb3f"></pre>
                        <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

                        <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
                        <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

                        <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                              <ruby id="bdb3f"></ruby>

                              哎呀哎呀视频在线观看