數據填充 · laravel 5.4

<article><h1>Laravel 數據庫之：數據填充</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#writing-seeders">編寫 Seeders</a><ul><li><a href="#using-model-factories">使用模型工廠</a></li><li><a href="#calling-additional-seeders">調用其他 Seeders</a></li></ul></li><li><a href="#running-seeders">運行 Seeders</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>Laravel 可以用 seed 類輕松地為數據庫填充測試數據。所有的 seed 類都存放在 <code class=" language-php">database/seeds</code> 目錄下。你可以任意為 seed 類命名，但是應該遵守類似 <code class=" language-php">UsersTableSeeder</code> 的命名規范。Laravel 默認定義了一個 <code class=" language-php">DatabaseSeeder</code> 類。可以在這個類中使用 <code class=" language-php">call</code> 方法來運行其它的 seed 類來控制數據填充的順序。<a name="writing-seeders"></a><h2><a href="#writing-seeders">編寫 Seeders</a></h2>可以通過運行 <code class=" language-php">make:seeder</code> <a href="/docs/5.4/artisan">Artisan 命令</a> 來生成一個 Seeder。所有由框架生成的 seeders 都將被放置在 <code class=" language-php">database/seeds</code> 目錄下：<pre class=" language-php"><code class=" language-php">php artisan make:seeder UsersTableSeeder</code></pre>一個 seeder 類只包含一個默認方法：<code class=" language-php">run</code>。這個方法在 <code class=" language-php">db:seed</code> <a href="/docs/5.4/artisan">Artisan 命令</a> 被調用時執行。在 <code class=" language-php">run</code> 方法里你可以為數據庫添加任何數據。你也可以用 <a href="/docs/5.4/queries">查詢語句構造器</a> 或 <a href="/docs/5.4/database-testing#writing-factories">Eloquent 模型工廠</a> 來手動添加數據。如下所示，我們來修改默認的 <code class=" language-php">DatabaseSeeder</code> 類并為 <code class=" language-php">run</code> 方法添加一條數據庫插入語句：<pre class=" language-php"><code class=" language-php"><?php use Illuminate\Database\Seeder; use Illuminate\Database\Eloquent\Model; class DatabaseSeeder extends Seeder { /** * 運行數據庫填充 * * @return void */ public function run() { DB::table('users')->insert([ 'name' => str_random(10), 'email' => str_random(10).'@gmail.com', 'password' => bcrypt('secret'), ]); } }</code></pre><a name="using-model-factories"></a><h3>使用模型工廠</h3>當然，手動為每個模型填充指定屬性很麻煩。作為替代方案，你可以使用 <a href="/docs/5.4/database-testing#writing-factories">模型工廠</a> 來輕松地生成大量數據庫記錄。首先，閱讀 <a href="/docs/5.4/database-testing#writing-factories">模型工廠文檔</a> 來學習如何定義工廠。一旦定義了工廠，就可以使用 <code class=" language-php">factory</code> 這個輔助函數來向數據庫中添加記錄。如下所示，我們來創建 50 個用戶并為每個用戶創建關聯：<pre class=" language-php"><code class=" language-php">/** * 運行數據庫填充 * * @return void */ public function run() { factory(App\User::class, 50)->create()->each(function ($u) { $u->posts()->save(factory(App\Post::class)->make()); }); }</code></pre><a name="calling-additional-seeders"></a><h3>調用其他 Seeders</h3>在 <code class=" language-php">DatabaseSeeder</code> 類中，你可以使用 <code class=" language-php">call</code> 方法來運行其他的 seed 類。為避免單個 seeder 類過大，可使用 <code class=" language-php">call</code> 方法將數據填充拆分成多個文件。只需簡單傳遞要運行的 seeder 類名稱即可：<pre class=" language-php"><code class=" language-php">/** * 運行數據庫填充 * * @return void */ public function run() { $this->call(UsersTableSeeder::class); $this->call(PostsTableSeeder::class); $this->call(CommentsTableSeeder::class); }</code></pre><a name="running-seeders"></a><h2><a href="#running-seeders">運行 Seeders</a></h2>一旦完成了 seeder 類的編寫，就可以使用 <code class=" language-php">db:seed</code> 這個 Artisan 命令來填充數據庫。在默認情況下，<code class=" language-php">db:seed</code> 命令將運行可以用來調用其他填充類的 <code class=" language-php">DatabaseSeeder</code> 類。但是可以用 <code class=" language-php">--class</code> 選項來單獨運行一個特定的 seeder 類：<pre class=" language-php"><code class=" language-php">php artisan db:seed php artisan db:seed --class=UsersTableSeeder</code></pre>也可以使用會先回滾再重新運行所有遷移的 <code class=" language-php">migrate:refresh</code> 命令來填充數據庫。這個命令在徹底重構數據庫時非常有用：<pre class=" language-php"><code class=" language-php">php artisan migrate:refresh --seed</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/houfei">@houfei</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/3472_1452945992.jpeg?imageView2/1/w/100/h/100"></td><td>翻譯</td><td>玩咖啡 & 鏟屎奴 & 努力回頭做碼農 <a href="https://github.com/houfei">@houfei</a> at Github</td></tr></tbody></table></article>