<article><h1>Eloquent: 集合</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#available-methods">可用的方法</a></li><li><a href="#custom-collections">自定義集合</a></li></ul><p><a name="introduction"></a></p><h2><a href="#introduction">簡介</a></h2><p>默認情況下 Eloquent 返回的都是一個 <code class=" language-php">Illuminate\<span class="token package">Database<span class="token punctuation">\</span>Eloquent<span class="token punctuation">\</span>Collection</span></code> 對象的實例,包含通過 <code class=" language-php">get</code> 方法或是訪問一個關聯來獲取到的結果。Eloquent 集合對象繼承了 Laravel <a href="/docs/5.4/collections">集合基類</a>,因此它自然也繼承了許多可用于與 Eloquent 模型交互的方法。</p><p>當然,所有集合都可以作為迭代器,來讓你像遍歷一個 PHP 數組一樣來遍歷一個集合:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$users</span> <span class="token operator">=</span> <span class="token scope">App<span class="token punctuation">\</span>User<span class="token punctuation">::</span></span><span class="token function">where<span class="token punctuation">(</span></span><span class="token string">'active'</span><span class="token punctuation">,</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">></span><span class="token function">get<span class="token punctuation">(</span></span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">foreach</span> <span class="token punctuation">(</span><span class="token variable">$users</span> <span class="token keyword">as</span> <span class="token variable">$user</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token keyword">echo</span> <span class="token variable">$user</span><span class="token operator">-</span><span class="token operator">></span><span class="token property">name</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span></code></pre><p>然而,集合比數組更強大的地方是其使用了各種 map / reduce 的直觀操作。例如,我們移除所有未激活的用戶模型和收集其余各個用戶的名字:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$users</span> <span class="token operator">=</span> <span class="token scope">App<span class="token punctuation">\</span>User<span class="token punctuation">::</span></span><span class="token function">where<span class="token punctuation">(</span></span><span class="token string">'active'</span><span class="token punctuation">,</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">></span><span class="token function">get<span class="token punctuation">(</span></span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token variable">$names</span> <span class="token operator">=</span> <span class="token variable">$users</span><span class="token operator">-</span><span class="token operator">></span><span class="token function">reject<span class="token punctuation">(</span></span><span class="token keyword">function</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 keyword">return</span> <span class="token variable">$user</span><span class="token operator">-</span><span class="token operator">></span><span class="token property">active</span> <span class="token operator">===</span> <span class="token boolean">false</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span><span class="token punctuation">)</span>
<span class="token operator">-</span><span class="token operator">></span><span class="token function">map<span class="token punctuation">(</span></span><span class="token keyword">function</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 keyword">return</span> <span class="token variable">$user</span><span class="token operator">-</span><span class="token operator">></span><span class="token property">name</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><blockquote class="has-icon note"><p><div class="flag"><span class="svg"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></span></div> 大部分的 Eloquent 集合會返回新的「Eloquent 集合」實例,但是 <code class=" language-php">pluck</code>, <code class=" language-php">keys</code>, <code class=" language-php">zip</code>, <code class=" language-php">collapse</code>, <code class=" language-php">flatten</code> 和 <code class=" language-php">flip</code> 方法會返回 <a href="/docs/5.4/collections">基礎集合</a> 實例。</p><p>相應的,如果一個 <code class=" language-php">map</code> 操作返回一個不包含任何 Eloquent 模型的集合,那么它將會自動轉換成基礎集合。</p></blockquote><p><a name="available-methods"></a></p><h2><a href="#available-methods">可用的方法</a></h2><h3>集合對象</h3><p>所有 Eloquent 集合都繼承了基礎的 <a href="/docs/5.4/collections">Laravel 集合</a> 對象。因此,他們也繼承了所有集合類提供的強大的方法:</p><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><div id="collection-method-list"><p><a href="/docs/5.4/collections#method-all">all</a> <a href="/docs/5.4/collections#method-avg">avg</a> <a href="/docs/5.4/collections#method-chunk">chunk</a> <a href="/docs/5.4/collections#method-collapse">collapse</a> <a href="/docs/5.4/collections#method-combine">combine</a> <a href="/docs/5.4/collections#method-contains">contains</a> <a href="/docs/5.4/collections#method-count">count</a> <a href="/docs/5.4/collections#method-diff">diff</a> <a href="/docs/5.4/collections#method-diffkeys">diffKeys</a> <a href="/docs/5.4/collections#method-each">each</a> <a href="/docs/5.4/collections#method-every">every</a> <a href="/docs/5.4/collections#method-except">except</a> <a href="/docs/5.4/collections#method-filter">filter</a> <a href="/docs/5.4/collections#method-first">first</a> <a href="/docs/5.4/collections#method-flatmap">flatMap</a> <a href="/docs/5.4/collections#method-flatten">flatten</a> <a href="/docs/5.4/collections#method-flip">flip</a> <a href="/docs/5.4/collections#method-forget">forget</a> <a href="/docs/5.4/collections#method-forpage">forPage</a> <a href="/docs/5.4/collections#method-get">get</a> <a href="/docs/5.4/collections#method-groupby">groupBy</a> <a href="/docs/5.4/collections#method-has">has</a> <a href="/docs/5.4/collections#method-implode">implode</a> <a href="/docs/5.4/collections#method-intersect">intersect</a> <a href="/docs/5.4/collections#method-isempty">isEmpty</a> <a href="/docs/5.4/collections#method-keyby">keyBy</a> <a href="/docs/5.4/collections#method-keys">keys</a> <a href="/docs/5.4/collections#method-last">last</a> <a href="/docs/5.4/collections#method-map">map</a> <a href="/docs/5.4/collections#method-max">max</a> <a href="/docs/5.4/collections#method-merge">merge</a> <a href="/docs/5.4/collections#method-min">min</a> <a href="/docs/5.4/collections#method-only">only</a> <a href="/docs/5.4/collections#method-pluck">pluck</a> <a href="/docs/5.4/collections#method-pop">pop</a> <a href="/docs/5.4/collections#method-prepend">prepend</a> <a href="/docs/5.4/collections#method-pull">pull</a> <a href="/docs/5.4/collections#method-push">push</a> <a href="/docs/5.4/collections#method-put">put</a> <a href="/docs/5.4/collections#method-random">random</a> <a href="/docs/5.4/collections#method-reduce">reduce</a> <a href="/docs/5.4/collections#method-reject">reject</a> <a href="/docs/5.4/collections#method-reverse">reverse</a> <a href="/docs/5.4/collections#method-search">search</a> <a href="/docs/5.4/collections#method-shift">shift</a> <a href="/docs/5.4/collections#method-shuffle">shuffle</a> <a href="/docs/5.4/collections#method-slice">slice</a> <a href="/docs/5.4/collections#method-sort">sort</a> <a href="/docs/5.4/collections#method-sortby">sortBy</a> <a href="/docs/5.4/collections#method-sortbydesc">sortByDesc</a> <a href="/docs/5.4/collections#method-splice">splice</a> <a href="/docs/5.4/collections#method-sum">sum</a> <a href="/docs/5.4/collections#method-take">take</a> <a href="/docs/5.4/collections#method-toarray">toArray</a> <a href="/docs/5.4/collections#method-tojson">toJson</a> <a href="/docs/5.4/collections#method-transform">transform</a> <a href="/docs/5.4/collections#method-union">union</a> <a href="/docs/5.4/collections#method-unique">unique</a> <a href="/docs/5.4/collections#method-values">values</a> <a href="/docs/5.4/collections#method-where">where</a> <a href="/docs/5.4/collections#method-wherestrict">whereStrict</a> <a href="/docs/5.4/collections#method-wherein">whereIn</a> <a href="/docs/5.4/collections#method-whereinloose">whereInLoose</a> <a href="/docs/5.4/collections#method-zip">zip</a></p></div><p><a name="custom-collections"></a></p><h2><a href="#custom-collections">自定義集合</a></h2><p>如果你需要使用一個自定義的 <code class=" language-php">Collection</code> 對象到自己的擴充方法上,則可以在模型中重寫 <code class=" language-php">newCollection</code> 方法:</p><pre class=" language-php"><code class=" language-php"><span class="token delimiter"><?php</span>
<span class="token keyword">namespace</span> <span class="token package">App</span><span class="token punctuation">;</span>
<span class="token keyword">use</span> <span class="token package">App<span class="token punctuation">\</span>CustomCollection</span><span class="token punctuation">;</span>
<span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Database<span class="token punctuation">\</span>Eloquent<span class="token punctuation">\</span>Model</span><span class="token punctuation">;</span>
<span class="token keyword">class</span> <span class="token class-name">User</span> <span class="token keyword">extends</span> <span class="token class-name">Model</span>
<span class="token punctuation">{</span>
<span class="token comment" spellcheck="true">/**
* 創建一個新的 Eloquent 集合實例對象。
*
* @param array $models
* @return \Illuminate\Database\Eloquent\Collection
*/</span>
<span class="token keyword">public</span> <span class="token keyword">function</span> <span class="token function">newCollection<span class="token punctuation">(</span></span><span class="token keyword">array</span> <span class="token variable">$models</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>
<span class="token keyword">return</span> <span class="token keyword">new</span> <span class="token class-name">CustomCollection</span><span class="token punctuation">(</span><span class="token variable">$models</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">newCollection</code> 方法,則可在任何 Eloquent 返回該模型的 <code class=" language-php">Collection</code> 實例時,接收到一個你的自定義集合的實例。如果你想要在應用程序的每個模型中使用自定義集合,則應該在所有的模型繼承的模型基類中重寫 <code class=" language-php">newCollection</code> 方法。</p><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://laravel-china.org/users/79">@skyverd</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/79_1427370664.jpeg?imageView2/1/w/100/h/100"></td><td>翻譯</td><td>全桟工程師,<a href="https://skyverd.com">時光博客</a></td></tr></tbody></table></article>
- 入門指南
- 安裝
- 配置信息
- 文件夾結構
- 請求周期
- 開發環境部署
- Valet
- Homestead
- 核心概念
- 服務提供者
- Facades
- Contracts
- 服務容器
- HTTP 層
- 路由
- 中間件
- CSRF 保護
- 控制器
- 請求
- 響應
- 視圖
- Session
- 表單驗證
- 前端
- Blade 模板
- 本地化
- 前端指南
- 編輯資源 Mix
- 安全
- API 認證
- 用戶認證
- 用戶授權
- 加密解密
- 哈希
- 重置密碼
- 數據庫
- 快速入門
- 查詢構造器
- 分頁
- 數據庫遷移
- Redis
- 數據填充
- Eloquent ORM
- Eloquent ORM快速入門
- 模型關聯
- Eloquent 集合
- 修改器
- 序列化
- 綜合話題
- Artisan 命令行
- 廣播系統
- 緩存系統
- 集合
- 錯誤與日志
- 事件系統
- 文件存儲
- 輔助函數
- 郵件發送
- 消息通知
- 擴展包開發
- 隊列
- 任務調度