【フレームワークLaravel】データベースのマイグレーションとは？実行するとどうなるの？

投稿：2024/09/12｜ 更新： 2024/09/25 ｜ 2907文字

今回はLaravelマイグレーションを取り上げます。最近(2024-09)の引き合いがWordPressばっかりでLaravel全然できてないんですけど、将来的に自分でなんか作るときに使うかもしれないので学習していました。さっそくマイグレーションやってみましょう。

1 Laravelのマイグレーションとは？
2 Laravelのマイグレーションを実行してみよう
3 マイグレーション実行結果
4 マイグレーションのロールバック（戻す）について
5 あとがき・まとめ

Laravelのマイグレーションとは？

データベースと連携しない場合は使う機会がないかもしれないんですけど、Laravelに搭載されているデータベースのバージョンやテーブル定義などの管理機能です。

SQL手打ちでやってもいいんですけど、テーブル構成が複雑になってくるとめんどくさく、打ちミスも怖いです。またチーム内で共有したり、同じ設計を使いまわしたりするときは重宝するのではないでしょうか。詳しくは公式ドキュメントもご覧ください。

Database: Migrations（英語・ブラウザで翻訳すればok）
https://laravel.com/docs/11.x/migrations

Laravelのマイグレーションを実行してみよう

データベース（sqlite）　元の状態

もとの状態はこんな感じ。わかりやすくするため、余計なテーブルは抜いておきました。以前使ったもの(sqlite_sequence，peopleテーブル)は残っていますが、ここにマイグレーションで新しいテーブルを作ってみたいと思います。

なお、環境設定ファイルをいじってデータベースに接続する方法については、当サイトの過去記事でも解説していますので、こちらもご覧ください。

（過去記事）DBクラスを使って、SQLiteデータベースのCRUD操作をやってみる
https://division-web.atelier-ss-agency.com/10473/laravel-db-class-crud/

１：コマンドでマイグレーションファイル作成

まずは、コマンドでマイグレーションファイルを作ります。cdでlaravelが入っているディレクトリを指定して、artisan make:migrationを入れます。うしろのcreate_t_user_tableというのは、『t_user』というテーブルを作りたいので、このように書いています（つくりたいテーブル名入れます）。

cd /xampp/htdocs/laravel
php artisan make:migration create_t_user_table

うまくいくと Migration [〇〇] created successfully.が出ます。

laravelインストール場所\database\migrations内に、このようにファイルが出来ました。この段階では、マイグレーションファイルができただけで、実際のデータベースには反映していません。

2024_09_12_133946_create_t_user_table.phpのなかみです。upとdownという２種のメソッドがあり、upがテーブル生成、downがテーブル削除です。

２：マイグレーションファイル内のupメソッドをエディット

ではさっそく、t_userテーブルの定義を書いていきます。以下のようなコードをメソッド内に追加しました。stringやintegerのようにそれぞれ型を指定しています。incrementsはオートインクリメントです。

$table->increments('id');
$table->string('mail','100');
$table->string('name','100');
$table->integer('age')->default(60);

ちなみに、管理人はちょっと間違ってるんですけど、SQLiteはVARCHAR(10)と指定しても、仕様上500万文字まで入るらしいです（指定しても意味がない）。mysqlとかだったらokなんですけど、SQLiteではstring('mail','100');のように、100文字指定は不要なようです。