前提条件

mac Big Sir(intel core)
LaraDockで環境構築済

※　今回はマイグレーションの話なので、基本的な操作や概念は変わりませんが、マイグレーションのコマンドがDockerのワークスペースに入って行うので、多少異なっています。

テーブルとマイグレーションファイルを作るコマンド

※ 必ず、Docker Desktopを立ち上げて、laradocディレクトリで
$ docker-compose up -d workspace php-fpm nginx mysql phpmyadmin
のように起動させた状態で行う。

$ docker-compose exec workspace＋コマンド
で、Dockerのワークスペースに入らなくてもコマンドを実行できる。

そのため、マイグレーションコマンドは以下のようになる。
必ずlaradocのディレクトリに移動してから以下のコマンドを実行する。

laradoc$ docker-compose exec workspace php artisan make:model テーブル名 --migration

末尾にオプション--migrationをつけると、テーブルを作ると同時に、マイグレーションファイルを作ってくれるので、そのマイグレーションファイルを開いて、どんなカラムが欲しいか書いていくときに使える。

マイグレーションファイルの所在

マイグレーションファイルはアプリケーションフォルダに存在するので、laradocフォルダの中ではなく、兄弟フォルダのアプリケーションフォルダの中にあるdatabase/migration/の中に作られていく。

テーブルができたら、ここを開いてカラムの指定を書いていこう。

マイグレーションファイルのファイル名の読み方

ファイル名は以下のように、日付と通し番号の後にcreate+テーブル名.phpになってる。

2014_10_12_100000_create_password_resets_table.php

`public function up()`の読み方

テーブルを作るときに、なんて名前のテーブルで、どんなカラムを作るのか？という指示をここに書き込む。

サンプル

public function up()
    {
        Schema::create('password_resets', function (Blueprint $table) {
            $table->string('email')->index();
            $table->string('token');
            $table->timestamp('created_at')->nullable();
        });
    }

これを元に説明します。

Schemaクラス

MySQLでもPostgreSQLでも、どんなデータベースでも操作できる魔法のクラス集

Schema::create()

テーブルを作るために使えるようにSchemaクラスが持ってるメソッド。
テーブル使いたい時にはこれ使う。

Schema::create('テーブル名', function (Blueprint $table) {ここに欲しいカラムについて書く}

第一引数にテーブル名、第二引数にどんなカラムが欲しいのか渡す関数を設定。
第二引数の関数に渡されてる引数でBlueprintはスキーマビルダとかいう新しいテーブルを定義するためのオブジェクト。$tableはテーブルオブジェクト。両方いつも使う決まり文句なので深く考えないで使いまわそう。

カラムの定義のやり方

基本は以下のような構成で書く

$table->カラムの型('カラムの名前')->カラム修飾子();

$table->bigIncrements('id');

idみたいな勝手に管理番号を割り振っておいてほしい物には$table->bigIncrements()こんな感じで書く。

$table->timestamps();

テーブルに作成日時と、更新日時を追加したいときは、これ書くと勝手にcreated_atカラムとupdated_atカラム作ってくれる。2個書かなくていい。便利。
$table->timestamp('created_at')->nullable();と、作成日時が欲しい時は引数に渡してあげるとこんな感じで書く。

->nullable()はColumn Modifiers(カラム修飾子)とかいうもので、ここにはnullが入ってもいいよ指定。

Column Modifiers

カラムの名前とカラムの型を指定するだけじゃなくて、

`public function down()`の読み方

ここに書くと、そのテーブルを消したいときに何をやって欲しいか？を指示できる。

サンプル

public function down()
    {
        Schema::dropIfExists('password_resets');
    }

Schema::dropIfExists

Schema::dropIfExists('テーブル名');で、消したいテーブル名を引数に入れると、消してくれるメソッド。
消すだけなのでここは記述量が少ない。簡単。

マイグレーションファイルを変更したらマイグレーションの実行

laradoc$ docker-compose exec workspace php artisan migrate

Migration table created successfully.て出たら成功。

データを入れてどんな表示になるか見たい…そうだSeederだ！

テーブルにSQLをぽちぽち打ってデータを挿入しなくても、Seederを使えば連想配列でデータを入れてくれて、ちょっとだけ楽できてチームで共有もできる…そんな便利機能がSeederです。

Seederファイルを作って連想配列を書く

以下のコマンドでテーブルごとに挿入したいデータを記述するSeederファイルを作ります

laradoc$ docker-compose exec workspace php artisan make:seeder ファイル名

Seeder created successfully.と出たら成功。

アプリケーションフォルダ/database/seedsにファイル名.phpというファイルが生成されます。
開くと、以下のような記述がありまます。

    public function run()
    {
        // ここに入れたいデータの連想配列を書いていく
    }

連想配列で登録したいデータを書いていきます。

public function run()
    {
        DB::table('テーブル名')->insert([
          [
            'カラム名1' => データ1,
            'カラム名2' => データ2,
          ],
          [
            'カラム名1' => データ3,
            'カラム名2' => データ4,
          ],
        ]);
    }

さっきのファイルが実行されるようにDatabaseSeeder.phpを変更

アプリケーションフォルダ/database/seeds/DatabaseSeeder.phpを開く。
すると以下のような記述があるのでここをカスタマイズする。

    public function run()
    {
        // $this->call(UsersTableSeeder::class);
    }

さっき連想配列を書いたファイル名は、その中でファイル名と同じクラスが作られていて、そのクラスの中に連想配列を書いた。

なので、ファイル名＝クラス名なので、ここではもともと入っていてコメントアウトされてる
// $this->call(UsersTableSeeder::class);
を利用して、ファイル名を書き込んであげるだけでOK！

    public function run()
    {
        $this->call(ファイル名::class);
    }

Seeder実行

laradocディレクトリにいることを確認してから、

laradoc$ docker-compose exec workspace php artisan db:seed

Database seeding completed successfully.と出れば成功！

Laradoc×Dockerでマイグレーション