イントロダクション
マイグレーションはデータベースのバージョンコントロールの一種です。これはデータベーススキーマの修正と現状のスキーマの状態を最新状態に保つことを両立させてくれます。典型的なマイグレーションはアプリケーションのスキーマを簡単に管理するためのスキーマ・ビルダーと一緒に使用されます。
マイグレーションの生成
マイグレーションを作成するには、Artisanコマンドラインツールでmigrate:makeコマンドを実行します。
php artisan migrate:make create_users_tableマイグレーションはapp/database/migrationsフォルダーに設置され、マイグレーションの順番をフレームワークに知らせるため、名前にタイムスタンプが含まれています。
さらにマイグレーションを作成時に--pathオプションを指定できます。インストールしたルートディレクトリーからの相対パスを指定します。
php artisan migrate:make foo --path=app/migrations--tableと--createオプションもテーブル名、マイグレーションで新しいテーブルを生成するかを指定するために使用できます。
php artisan migrate:make add_votes_to_user_table --table=users
php artisan migrate:make create_users_table --create=usersマイグレーションの実行
未実行の全マイグレーションを実行する
php artisan migrate指定されたパスの全未実行マイグレーションを実行する
php artisan migrate --path=app/foo/migrationsパッケージの全未実行マイグレーションを実行する
php artisan migrate --package=vendor/package注目："class not found"エラーがマイグレーション実行時に発生する場合は、
composer dump-autoloadコマンドを実行してみてください。
実働環境でマイグレーションを強制する
いくつかのマイグレーション操作は破壊的です。つまり、データーを失う可能性があります。実働環境のデータベースでこうしたコマンドを実行してしまうことを守るために、コマンドが実行される前に、確認のプロンプトが表示されます。このようにコマンド実行時のプロンプトを出さないためには、--forceフラグを指定してください。
php artisan migrate --forceマイグレーションのロールバック
最後のマイグレーション操作をロールバックする
php artisan migrate:rollback全マイグレーションをロールバックする
php artisan migrate:reset全マイグレーションをロールバックし、再度全部実行する
php artisan migrate:refresh
php artisan migrate:refresh --seedデータベース初期値設定
更に初期値設定(seed)クラスを使用し、テストデーターをデーターベースに設定する、シンプルな方法もLaravelには備わっています。全部の初期値設定クラスはapp/database/seedsに保存されます。初期値設定クラスには好きな名前を付けられます。ですがUserTableSeederなどのような分かりやすい規則に従ったほうが良いでしょう。デフォルトとして、DatabaseSeederクラスが定義されています。このクラスから、callメソッドを使い他の初期値設定クラスを呼び出すことで、値を設定する順番をコントロールできます。
データベース初期値設定の例
class DatabaseSeeder extends Seeder {
public function run()
{
$this->call('UserTableSeeder');
$this->command->info('User table seeded!');
}
}
class UserTableSeeder extends Seeder {
public function run()
{
DB::table('users')->delete();
User::create(array('email' => 'foo@bar.com'));
}
}データベースに初期データーを設置するには、Artisanコマンドラインツールでdb:seedコマンドを使ってください。
php artisan db:seedデフォルトでは、db:seedコマンドは、他の初期値設定クラスを呼び出しているDatabaseSeederクラスを実行します。個別に初期値設定クラスを呼び出したい場合は、--classオプションを指定して実行することができます。
php artisan db:seed --class=UserTableSeederまたmigrate:refreshコマンドを使用し、マイグレーションを全部ロールバックし、再度実行することでも、初期データーを設置できます。
php artisan migrate:refresh --seed