【フレームワークLaravel】データベースのシーディングやってみる・コマンドやSeederファイルの書き方

投稿：2024/09/15｜ 更新： 2024/09/25 ｜ 3006文字

今回は、前回の記事で行った『Laravelデータベースマイグレーション』に続いて、データベースのシーディングを行ってみます。前回同様、コマンドやエディットするファイルなどの手順も紹介。さっそくやってみましょうか。

1 Laravelのデータベースシーディングとは？
2 Laravelのデータベースシーディング方法
3 シーディングの実行結果
4 エラー例（Class "Database\Seeders\DB" not found）
5 あとがき・まとめ

Laravelのデータベースシーディングとは？

ダミーデータなどの、データベースに初期データセットを入力するのを、プログラミング系の用語で『シーディング』というようです。管理人は普通にダミーデータ入力と言っていたため、この用語は最近になって知りました。

Laravelにもシーディングの機能はあって、DatabaseSeederクラスのメソッドを呼んだりして実行できる、とのことです。詳しくは公式ドキュメントも読んでみてください。

laravel　seeding
https://laravel.com/docs/11.x/seeding

Laravelのデータベースシーディング方法

データベース元の状態

前回の記事で、マイグレーションを使って、Laravelに接続しているsqlデータベースに、『t_user』というテーブルを用意しました。この段階では実際のデータがまだ入っていません。そこで今回は、シーディングを使って実際のデータを行っていきます。

（過去記事）Laravelデータベースのマイグレーションとは？実行するとどうなるの？
https://division-web.atelier-ss-agency.com/10538/laravel-migration/

make:seederコマンドでシーディングのファイルを作成

まずは、シーディングのファイルを作成します。これには専用のartisanコマンドが用意されていますね。作るファイル名は、テーブル名に合わせて『t_userTableSeeder』としましょうか。コマンドは以下の通りです。（cdでlaravelが入っているディレクトリを指定しています。make:seederの後ろがファイル名。）

cd /xampp/htdocs/laravel
php artisan make:seeder t_userTableSeeder

laravel/database/seeders内に『t_userTableSeeder.php』が作成されました。

t_userTableSeeder.phpの中身はこんな感じ。『run』というメソッドがありますけど、中身は無し。ここにシーディング時に行いたい内容を書いていきます。

なお『function run():void』というのがありますが、PHP 7.1.0 以降の関数が値を返さないことを示す型です。PHPマニュアル記載内容だと『戻り値を使おうとした場合はその値は null と評価』とのことです。無くても動かすことができました（return内容をデータベースに入れる、というわけではないため）。

作成されたt_userTableSeeder.phpに処理記載

生成されたt_userTableSeeder.phpをエディットします。runメソッド中身はこんな感じ。いっこいっこ作ってもいいんんですけど、今回は『ダミーデータをシーディングでサクッと入れる』ということで、ループで回して10件入れます（idはオートインクリメントで自動で入ります）。

public function run()
{
　for($i = 1; $i <= 10; $i++){v 　　$age = $i+20;
　　$param = [
　　　'mail'=>'num'. $i. '-info@example.net',
　　　'name'=>'〇〇〇no.'. $i,
　　　'age'=>$age,
　　];
　　DB::table('t_user')->insert($param);
　}
}

また『use Illuminate\Support\Facades\DB;』をロードしている理由は、DBクラスのinsertを使いたいからです。