# 數據庫: 數據填充
- [簡介](#introduction)
- [編寫 Seeders](#writing-seeders)
- [使用模型工廠](#using-model-factories)
- [調用其它的 Seeders](#calling-additional-seeders)
- [運行 Seeders](#running-seeders)
<a name="introduction"></a>
## 簡介
Laravel 可以簡單的使用 seed 類來給數據庫填充測試數據。所有的 seed 類都放在 `database/seeds` 目錄下。你可以任意地為 Seed 類命名,但是應該遵守某些大小寫規范,可用類似 `UserTableSeeder` 之類的命名。 Laravle 默認為你定義了一個 `DatabaseSeeder` 類。你可以在這個類中使用 `call` 方法來運行其它的 seed 類,以借此控制數據填充的順序。
<a name="writing-seeders"></a>
## 編寫數據填充
你可以通過 `make:seeder` [Artisan 命令](/docs/{{version}}/artisan) 來生成一個 Seeder。所有通過框架生成的 Seeder 都將被放置在 `database/seeders` 路徑:
php artisan make:seeder UsersTableSeeder
在 seeder 類里只有一個默認方法:`run`。當運行 `db:seed` [Artisan 命令](/docs/{{version}}/artisan) 時就會調用此方法。你可以在 `run` 方法中給數據庫添加任何數據。你可使用 [查詢語句構造器](/docs/{{version}}/queries) 或 [Eloquent 模型工廠](/docs/{{version}}/testing#model-factories) 來手動添加數據。
如下所示,我們將修改 Laravel 預先生成好的 `DatabaseSeeder` 類來給 `run` 方法添加一段可在數據庫添加數據的語法:
<?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'),
]);
}
}
<a name="using-model-factories"></a>
### 使用模型工廠
手動為每一個 seed 模型一一指定屬性是很麻煩的一件事。作為替代方案,你可以使用 [模型工廠](/docs/{{version}}/testing#model-factories) 來幫助你更便捷的生成大量數據庫數據。首先,閱讀 [模型工廠的文檔](/docs/{{version}}/testing#model-factories) 來學習如何定義你的工廠。一旦工廠被定義,就能使用 `factory` 這個輔助函數函數來添加數據到數據庫。
讓我們來創建 50 個用戶并為每個用戶創建一個關聯:
/**
* 運行數據庫填充。
*
* @return void
*/
public function run()
{
factory(App\User::class, 50)->create()->each(function($u) {
$u->posts()->save(factory(App\Post::class)->make());
});
}
<a name="calling-additional-seeders"></a>
### 調用其它的 Seeders
在 `DatabaseSeeder` 類中,你可以使用 `call` 方法來運行其它的 seed 類。為避免發生單個 seeder 類變得太大的情況,可使用 `call`方法來將數據填充拆分成多個文件。只需簡單傳遞你想要運行的 seeder 類名稱即可:
/**
* 運行數據庫填充。
*
* @return void
*/
public function run()
{
$this->call(UsersTableSeeder::class);
$this->call(PostsTableSeeder::class);
$this->call(CommentsTableSeeder::class);
}
<a name="running-seeders"></a>
## 運行數據填充
一旦你編寫完 seeder 類,則可以使用 `db:seed` Artisan 命令來對數據庫進行數據填充。在默認的情況下,`db:seed` 命令將運行 `DatabaseSeeder` 類,并通過它來調用其它的 seed 類。但是,你也可以使用 `--class` 選項來單獨運行一個特定的 seeder 類:
php artisan db:seed
php artisan db:seed --class=UserTableSeeder
你也可以使用 `migrate:refresh` 命令來對數據庫進行數據填充,它會回滾并重新運行所有遷移。這在對數據庫進行重構時非常有用:
php artisan migrate:refresh --seed
## 譯者署名
| 用戶名 | 頭像 | 職能 | 簽名 |
|---|---|---|---|
| [@silvercell](https://github.com/silvercell) | <img class="avatar-66 rm-style" src="https://avatars2.githubusercontent.com/u/20363459?v=3&u=2234d736aa27209a2e986d4d789f95c6d110aa0c&s=140"> | 翻譯 | [你今天吃藥了嗎?](http://www.cxdog.com) |
| [@buer](https://github.com/buer0) | <img class="avatar-66 rm-style" src="https://avatars3.githubusercontent.com/u/22141008?v=3&u=f14a9d540240e1d39079dc1319eb146a91aabfa8&s=140"> | 翻譯 | [已放棄治療!](http://www.cxdog.com) |
- 說明
- 翻譯說明
- 發行說明
- 升級說明
- 貢獻導引
- 入門指南
- 安裝
- 配置信息
- 文件夾結構
- 錯誤與日志
- 開發環境
- HomeStead
- Valet
- 核心概念
- 服務容器
- 服務提供者
- 門面(facades)
- contracts
- HTTP層
- 路由
- 中間件
- CSRF保護
- 控制器
- 請求
- 響應
- Session
- 表單驗證
- 視圖與模板
- 視圖
- Blade模板
- 本地化
- Javascript與CSS
- 入門指南
- laravel-elixir
- 安全
- 用戶認證
- 用戶授權
- 重置密碼
- API授權
- 加密解密
- 哈希
- 綜合話題
- 廣播系統
- 緩存系統
- 事件系統
- 文件存儲
- 郵件發送
- 消息通知
- 隊列
- 數據庫
- 快速入門
- 查詢構造器
- 分頁
- 數據庫遷移
- 數據填充
- redis
- Eloquent ORM
- 快速入門
- 模型關聯
- Eloquent集合
- 修改器
- 序列化
- Artisan控制臺
- Artisan 命令行
- 任務調度
- 測試
- 快速入門
- 應用程序測試
- 數據庫測試
- 模擬器
- 官方擴展包
- Cashier交易包
- Envoy 部署工具
- Passport OAuth 認證
- Scout 全文搜索
- Socialite 社交化登錄
- 附錄
- 集合
- 輔助函數
- 擴展包開發
- 交流說明