# Laravel 數據庫之:數據填充
- [簡介](#introduction)
- [編寫 Seeders](#writing-seeders)
- [使用模型工廠](#using-model-factories)
- [調用其他 Seeders](#calling-additional-seeders)
- [ 運行 Seeders](#running-seeders)
<a name="introduction"></a>
## 簡介
Laravel 可以用 seed 類輕松地為數據庫填充測試數據。所有的 seed 類都存放在 `database/seeds` 目錄下。你可以任意為 seed 類命名,但是應該遵守類似 `UsersTableSeeder` 的命名規范。Laravel 默認定義了一個 `DatabaseSeeder` 類。可以在這個類中使用 `call` 方法來運行其它的 seed 類來控制數據填充的順序。
<a name="writing-seeders"></a>
## 編寫 Seeders
可以通過運行 `make:seeder` [Artisan 命令](/docs/{{version}}/artisan) 來生成一個 Seeder。所有由框架生成的 seeders 都將被放置在 `database/seeds` 目錄下:
php artisan make:seeder UsersTableSeeder
一個 seeder 類只包含一個默認方法:`run`。這個方法在 `db:seed` [Artisan 命令](/docs/{{version}}/artisan) 被調用時執行。在 `run` 方法里你可以為數據庫添加任何數據。你也可以用 [查詢語句構造器](/docs/{{version}}/queries) 或 [Eloquent 模型工廠](/docs/{{version}}/database-testing#writing-factories) 來手動添加數據。
如下所示,我們來修改默認的 `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>
### 使用模型工廠
當然,手動為每個模型填充指定屬性很麻煩。作為替代方案,你可以使用 [模型工廠](/docs/{{version}}/database-testing#writing-factories) 來輕松地生成大量數據庫記錄。首先,閱讀 [模型工廠文檔](/docs/{{version}}/database-testing#writing-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>
## 運行 Seeders
一旦完成了 seeder 類的編寫,就可以使用 `db:seed` 這個 Artisan 命令來填充數據庫。在默認情況下,`db:seed` 命令將運行可以用來調用其他填充類的 `DatabaseSeeder` 類。但是可以用 `--class` 選項來單獨運行一個特定的 seeder 類:
php artisan db:seed
php artisan db:seed --class=UsersTableSeeder
也可以使用會先回滾再重新運行所有遷移的 `migrate:refresh` 命令來填充數據庫。這個命令在徹底重構數據庫時非常有用:
php artisan migrate:refresh --seed
## 譯者署名
| 用戶名 | 頭像 | 職能 | 簽名 |
|---|---|---|---|
| [@wqer1019](https://laravel-china.org/users/5435) | <img class="avatar-66 rm-style" src="https://avatars3.githubusercontent.com/u/9254545?v=4&s=100"> | 翻譯 | laravel是世界上最優雅的框架,[@wqer1019](https://github.com/wqer1019) at Github |
---
> {note} 歡迎任何形式的轉載,但請務必注明出處,尊重他人勞動共創開源社區。
>
> 轉載請注明:本文檔由 Laravel China 社區 [laravel-china.org](https://laravel-china.org) 組織翻譯,詳見 [翻譯召集帖](https://laravel-china.org/topics/5756/laravel-55-document-translation-call-come-and-join-the-translation)。
>
> 文檔永久地址: https://d.laravel-china.org
- 說明
- 翻譯說明
- 發行說明
- 升級說明
- 貢獻導引
- 入門指南
- 安裝
- 配置信息
- 文件夾結構
- HomeStead
- Valet
- 核心架構
- 請求周期
- 服務容器
- 服務提供者
- 門面(Facades)
- Contracts
- 基礎功能
- 路由
- 中間件
- CSRF 保護
- 控制器
- 請求
- 響應
- 視圖
- 重定向
- Session
- 表單驗證
- 錯誤與日志
- 前端開發
- Blade 模板
- 本地化
- 前端指南
- 編輯資源 Mix
- 安全
- 用戶認證
- API認證
- 用戶授權
- 加密解密
- 哈希
- 重置密碼
- 綜合話題
- Artisan 命令行
- 廣播系統
- 緩存系統
- 集合
- 事件系統
- 文件存儲
- 輔助函數
- 郵件發送
- 消息通知
- 擴展包開發
- 隊列
- 任務調度
- 數據庫
- 快速入門
- 查詢構造器
- 分頁
- 數據庫遷移
- 數據填充
- Redis
- Eloquent ORM
- 快速入門
- 模型關聯
- Eloquent 集合
- 修改器
- API 資源
- 序列化
- 測試
- 快速入門
- HTTP 測試
- 瀏覽器測試 Dusk
- 數據庫測試
- 測試模擬器
- 官方擴展包
- Cashier 交易工具包
- Envoy 部署工具
- Horizon
- Passport OAuth 認證
- Scout 全文搜索
- Socialite 社交化登錄
- 交流說明