Laravel 的数据库迁移的方法


            本文介绍了Laravel 的数据库迁移的方法，分享给大家，具体如下：



生成迁移

--table 和 --create 选项可用来指定数据表的名称，或是该迁移被执行时会创建的新数据表。这些选项需在预生成迁移文件时填入指定的数据表：





php artisan make:migration create_users_table

php artisan make:migration create_users_table --create=users

php artisan make:migration add_votes_to_users_table --table=users



添加字段

\database\migrations\2017_07_30_133748_create_users_table.php





<?php



use Illuminate\Support\Facades\Schema;

use Illuminate\Database\Schema\Blueprint;

use Illuminate\Database\Migrations\Migration;



class CreateUsersTable extends Migration

{

  /**

   * 运行数据库迁移

   *

   * @return void

   */

  public function up()

  {

    //

      Schema::create('users',function (Blueprint $table){

        $table->increments('id')->comment('递增ID');

        $table->string('email',60)->comment('会员Email');

        $table->string('phone',20)->comment('会员手机号');

        $table->string('username',60)->comment('用户名');

        $table->string('password',32)->comment('用户密码');

        $table->char('rank',10)->comment('会员等级');

        $table->unsignedSmallInteger('sex')->comment('性别;0保密;1男;2女');

        $table->unsignedSmallInteger('status')->comment('用户状态');

        $table->ipAddress('last_ip')->default('0.0.0.0')->comment('最后一次登录IP');

        $table->timeTz('last_login')->comment('最后一次登录时间');

        $table->timestamps();

      });

  }



  /**

   * 回滚数据库迁移

   *

   * @return void

   */

  public function down()

  {

    //

    Schema::drop('users');

  }

}







要创建一张新的数据表，可以使用 Schema facade 的 create 方法。create 方法接收两个参数：第一个参数为数据表的名称，第二个参数为一个 闭包 ，此闭包会接收一个用于定义新数据表的 Blueprint 对象

你可以方便地使用 hasTable 和 hasColumn 方法来检查数据表或字段是否存在：





if (Schema::hasTable('users')) {

  //

}

if (Schema::hasColumn('users', 'email')) {

  //

}





如果你想要在一个非默认的数据库连接中进行数据库结构操作，可以使用 connection 方法：





Schema::connection('foo')->create('users', function (Blueprint $table) {

  $table->increments('id');

});



你可以在数据库结构构造器上设置 engine 属性来设置数据表的存储引擎：





Schema::create('users', function (Blueprint $table) {

  $table->engine = 'InnoDB';

  $table->increments('id');

});



重命名与删除数据表





Schema::rename($from, $to);//重命名



//删除已存在的数据表

Schema::drop('users');

Schema::dropIfExists('users');





创建字段





Schema::table('users', function (Blueprint $table) {

  $table->string('email');

});







  

    

      命令

      描述

    

  

  

    

      $table->bigIncrements('id');

      递增 ID（主键），相当于「UNSIGNED BIG INTEGER」型态。

    

    

      $table->bigInteger('votes');

      相当于 BIGINT 型态。

    

    

      $table->binary('data');

      相当于 BLOB 型态。

    

    

      $table->boolean('confirmed');

      相当于 BOOLEAN 型态。

    

    

      $table->char('name', 4);

      相当于 CHAR 型态，并带有长度。

    

    

      $table->date('created_at');

      相当于 DATE 型态

    

    

      $table->dateTime('created_at');

      相当于 DATETIME 型态。

    

    

      $table->dateTimeTz('created_at');

      DATETIME (带时区) 形态

    

    

      $table->decimal('amount', 5, 2);

      相当于 DECIMAL 型态，并带有精度与基数。

    

    

      $table->double('column', 15, 8);

      相当于 DOUBLE 型态，总共有 15 位数，在小数点后面有 8 位数。

    

    

      $table->enum('choices', ['foo', 'bar']);

      相当于 ENUM 型态。

    

    

      $table->float('amount', 8, 2);

      相当于 FLOAT 型态，总共有 8 位数，在小数点后面有 2 位数。

    

    

      $table->increments('id');

      递增的 ID (主键)，使用相当于「UNSIGNED INTEGER」的型态。

    

    

      $table->integer('votes');

      相当于 INTEGER 型态。

    

    

      $table->ipAddress('visitor');

      相当于 IP 地址形态。

    

    

      $table->json('options');

      相当于 JSON 型态。

    

    

      $table->jsonb('options');

      相当于 JSONB 型态。

    

    

      $table->longText('description');

      相当于 LONGTEXT 型态。

    

    

      $table->macAddress('device');

      相当于 MAC 地址形态。

    

    

      $table->mediumIncrements('id');

      递增 ID (主键) ，相当于「UNSIGNED MEDIUM INTEGER」型态。

    

    

      $table->mediumInteger('numbers');

      相当于 MEDIUMINT 型态。

    

    

      $table->mediumText('description');

      相当于 MEDIUMTEXT 型态。

    

    

      $table->morphs('taggable');

      加入整数 taggable_id 与字符串 taggable_type。

    

    

      $table->nullableMorphs('taggable');

      与 morphs() 字段相同，但允许为NULL。

    

    

      $table->nullableTimestamps();

      与 timestamps() 相同，但允许为 NULL。

    

    

      $table->rememberToken();

      加入 remember_token 并使用 VARCHAR(100) NULL。

    

    

      $table->smallIncrements('id');

      递增 ID (主键) ，相当于「UNSIGNED SMALL INTEGER」型态。

    

    

      $table->smallInteger('votes');

      相当于 SMALLINT 型态。

    

    

      $table->softDeletes();

      加入 deleted_at 字段用于软删除操作。

    

    

      $table->string('email');

      相当于 VARCHAR 型态。

    

    

      $table->string('name', 100);

      相当于 VARCHAR 型态，并带有长度。

    

    

      $table->text('description');

      相当于 TEXT 型态。

    

    

      $table->time('sunrise');

      相当于 TIME 型态。

    

    

      $table->timeTz('sunrise');

      相当于 TIME (带时区) 形态。

    

    

      $table->tinyInteger('numbers');

      相当于 TINYINT 型态。

    

    

      $table->timestamp('added_on');

      相当于 TIMESTAMP 型态。

    

    

      $table->timestampTz('added_on');

      相当于 TIMESTAMP (带时区) 形态。

    

    

      $table->timestamps();

      加入 created_at 和 updated_at 字段。

    

    

      $table->timestampsTz();

      加入 created_at and updated_at (带时区) 字段，并允许为NULL。

    

    

      $table->unsignedBigInteger('votes');

      相当于 Unsigned BIGINT 型态。

    

    

      $table->unsignedInteger('votes');

      相当于 Unsigned INT 型态。

    

    

      $table->unsignedMediumInteger('votes');

      相当于 Unsigned MEDIUMINT 型态。

    

    

      $table->unsignedSmallInteger('votes');

      相当于 Unsigned SMALLINT 型态。

    

    

      $table->unsignedTinyInteger('votes');

      相当于 Unsigned TINYINT 型态。

    

    

      $table->uuid('id');

      相当于 UUID 型态。

    

  





字段修饰





Schema::table('users', function (Blueprint $table) {

  $table->string('email')->nullable();

});







  

    

      Modifier

      Description

    

  

  

    

      ->after('column')

      将此字段放置在其它字段「之后」（仅限 MySQL）

    

    

      ->comment('my comment')

      增加注释

    

    

      ->default($value)

      为此字段指定「默认」值

    

    

      ->first()

      将此字段放置在数据表的「首位」（仅限 MySQL）

    

    

      ->nullable()

      此字段允许写入 NULL 值

    

    

      ->storedAs($expression)

      创建一个存储的生成字段 （仅限 MySQL）

    

    

      ->unsigned()

      设置 integer 字段为 UNSIGNED

    

    

      ->virtualAs($expression)

      创建一个虚拟的生成字段 （仅限 MySQL）

    

  





字段更新





Schema::table('users', function (Blueprint $table) {

  $table->string('phone',20)->change();

  $table->string('username',60)->->nullable()->change();

});



重命名字段





Schema::table('users', function (Blueprint $table) {

  $table->renameColumn('from', 'to');

});



字段移除





Schema::table('users', function (Blueprint $table) {

  $table->dropColumn(['last_ip', 'last_login']);

});



在使用字段更新，重命名字段，字段移除之前，请务必在你的 composer.json文件require键名中添加< "doctrine/dbal": "^2.5">值。然后composer update进行更新或





composer require doctrine/dbal



创建索引





$table->string('email')->unique();









  

    

      Command

      Description

    

  

  

    

      $table->primary('id');

      加入主键。

    

    

      $table->primary(['first', 'last']);

      加入复合键。

    

    

      $table->unique('email');

      加入唯一索引。

    

    

      $table->unique('state', 'my_index_name');

      自定义索引名称。

    

    

      $table->unique(['first', 'last']);

      加入复合唯一键。

    

    

      $table->index('state');

      加入基本索引。

    

  





开启和关闭外键约束





Schema::enableForeignKeyConstraints();

Schema::disableForeignKeyConstraints();





运行迁移





php artisan migrate



在线上环境强制执行迁移





php artisan migrate --force



回滚迁移

若要回滚最后一次迁移，则可以使用 rollback 命令。此命令是对上一次执行的「批量」迁移回滚，其中可能包括多个迁移文件：





php artisan migrate:rollback





在 rollback 命令后加上 step 参数，你可以限制回滚迁移的个数。例如，下面的命令将会回滚最后的 5 个迁移。





php artisan migrate:rollback --step=5



migrate:reset 命令可以回滚应用程序中的所有迁移：





php artisan migrate:reset



使用单个命令来执行回滚或迁移

migrate:refresh 命令不仅会回滚数据库的所有迁移还会接着运行 migrate 命令。所以此命令可以有效的重新创建整个数据库：





php artisan migrate:refresh

// 刷新数据库结构并执行数据填充

php artisan migrate:refresh --seed



使用 refresh 命令并加上 step 参数，你也可以限制执行回滚和再迁移的个数。比如，下面的命令会回滚并再迁移最后的 5 个迁移：





php artisan migrate:refresh --step=5



无法生成迁移文件

在 Laravel 项目中，由于测试，有时候用 PHP artisan make:migration create_xxx_table 创建数据库迁移。如果把创建的迁移文件 database/migrations/2017_07_30_133748_create_xxx_table.php 文件给删除了，再次执行 php artisan make:migration create_xxx_table 会报错：

复制代码 代码如下:

[ErrorException]                                                                                                                                          

 include(E:\laraver\vendor\composer/../../database/migrations/2017_07_30_133748_create_users_table.php): failed to open stream: No such file or directory  



重新运行 composer update 又可以执行上面的命令了。



以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持中文源码网。