Laravel使用 Artisan命令make:migration的一些细节
2018-05-26 13:54:52   点击：

Migration，即迁移。Laravel的迁移机制为数据库提供了非常方便的版本控制，简单来说，首先它能够让项目的复制变得简单，数据表结构不需要导入导出，通过migration记录，就可以简单的通过“php artisan migrate"一件同步数据结构；其次，数据表的维护和回滚都有据可依，而且操作便捷，操作数据表结构不需要单独操作Mysql命令，也不需要依赖阿里DMS和phpMyAdmin这类可视化工具。当然，它也更适合团队的协同作战。

 Laravel创建数据库语句（在项目根目录下运行）：

php artisan make:migration create_users_table --create users

Laravel修改数据库语句（其实没有区别）

php artisan make:migration add_votes_to_users_table --table=users 

生成的文件地址位于 database/migrations 目录下。每个迁移文件名都包含时间戳。

--table 选项可用来指定数据表的名称。

--create 该迁移被执行时是否将创建的新数据表。

这里的"create_users_table"命名其实没有限制，不过老九还是建议按照官方文档的格式来写，这样一来方便记录和认知自己的数据表结构，也方便后期的维护和处理。

 

迁移类通常会包含2个方法： up 和 down。 up 方法用于添加新的数据表， 字段或者索引到数据库， 而 down 方法就是 up 方法的反操作，和 up 里的操作相反。

在这2个方法中都要用到Laravel 的 Schema 构建器来创建和修改表，若要了解 Schema 生成器中的所有可用方法 ，可以查看官方文档。不过简单操作并不需要太多的了解。

迁移类通常会包含2个方法： up 和 down。 up 方法用于添加新的数据表， 字段或者索引到数据库， 而 down 方法就是 up 方法的反操作，和 up 里的操作相反。

操作举例：

<?php

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateFlightsTable extends Migration
{
    /**
     * 运行数据库迁移
     *
     * @return void
     */
    public function up()
    {
        Schema::create('flights', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->string('airline');
            $table->timestamps();
        });
    }

    /**
     * 回滚数据库迁移
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('flights');
    }
}

迁移文件保存之后，通过php artisan migrate生成实现即可。在生产环境下，如果要强制忽略系统的提示运行命令，可以通过php artisan migrate --force强制执行，不过可能会导致数据丢失的操作要慎用。

migration执行记录Laravel是通过一张单表来进行详细记录的。若要回滚最后一次迁移， 可以使用 rollback 命令。 此命令将回滚最后一次“迁移”的操作，其中可能包含多个迁移文件：php artisan migrate:rollback。

你可以在 rollback 命令后面加上 step 参数，来限制回滚迁移的个数。 例如，以下命令将回滚最近五次迁移：php artisan migrate:rollback --step=5

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

 

创建数据表

Schema::create('users', function (Blueprint $table) {
    $table->increments('id');
});

create 方法接受两个参数：第一个参数为数据表的名称，第二个参数是 Closure ，此闭包会接收一个用于定义新数据表的 Blueprint 对象，该对象一般不用额外操作。 

检查数据表 / 字段是否存在

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

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

另外，如果对非默认连接的数据库连接执行结构操作：

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

更多配置： 

命令	描述
$table->engine = 'InnoDB';	指定表存储引擎 (MySQL)。
$table->charset = 'utf8';	指定数据表的默认字符集 (MySQL)。
$table->collation = 'utf8_unicode_ci';	指定数据表默认的排序规则 (MySQL)。
$table->temporary();	创建临时表 (不支持SQL Server)。

 

重命名 / 删除数据表

若要重命名数据表，可以使用 rename 方法：Schema::rename($from, $to);

删除数据表

使用 drop 或 dropIfExists 方法：

Schema::drop('users');

Schema::dropIfExists('users');

创建字段 

Schema::table('users', function (Blueprint $table) {
    $table->string('email');
});

尤其的，如果要把字段设置为 "可空"，就使用 nullable 方法：

Schema::table('users', function (Blueprint $table) {
    $table->string('email')->nullable();
});

可用的字段类型 

Command	Description
$table->bigIncrements('id');	递增 ID（主键），相当于「UNSIGNED BIG INTEGER」
$table->bigInteger('votes');	相当于 BIGINT
$table->binary('data');	相当于 BLOB
$table->boolean('confirmed');	相当于 BOOLEAN
$table->char('name', 100);	相当于带有长度的 CHAR
$table->date('created_at');	相当于 DATE
$table->dateTime('created_at');	相当于 DATETIME
$table->dateTimeTz('created_at');	相当于带时区 DATETIME
$table->decimal('amount', 8, 2);	相当于带有精度与基数 DECIMAL
$table->double('amount', 8, 2);	相当于带有精度与基数 DOUBLE
$table->enum('level', ['easy', 'hard']);	相当于 ENUM
$table->float('amount', 8, 2);	相当于带有精度与基数 FLOAT
$table->geometry('positions');	相当于 GEOMETRY
$table->geometryCollection('positions');	相当于 GEOMETRYCOLLECTION
$table->increments('id');	递增的 ID (主键)，相当于「UNSIGNED INTEGER」
$table->integer('votes');	相当于 INTEGER
$table->ipAddress('visitor');	相当于 IP 地址
$table->json('options');	相当于 JSON
$table->jsonb('options');	相当于 JSONB
$table->lineString('positions');	相当于 LINESTRING
$table->longText('description');	相当于 LONGTEXT
$table->macAddress('device');	相当于 MAC 地址
$table->mediumIncrements('id');	递增 ID (主键) ，相当于「UNSIGNED MEDIUM INTEGER」
$table->mediumInteger('votes');	相当于 MEDIUMINT
$table->mediumText('description');	相当于 MEDIUMTEXT
$table->morphs('taggable');	相当于加入递增的 taggable_id 与字符串 taggable_type
$table->multiLineString('positions');	相当于 MULTILINESTRING
$table->multiPoint('positions');	相当于 MULTIPOINT
$table->multiPolygon('positions');	相当于 MULTIPOLYGON
$table->nullableMorphs('taggable');	相当于可空版本的 morphs() 字段
$table->nullableTimestamps();	相当于可空版本的 timestamps() 字段
$table->point('position');	相当于 POINT
$table->polygon('positions');	相当于 POLYGON
$table->rememberToken();	相当于可空版本的 VARCHAR(100) 的 remember_token 字段
$table->smallIncrements('id');	递增 ID (主键) ，相当于「UNSIGNED SMALL INTEGER」
$table->smallInteger('votes');	相当于 SMALLINT
$table->softDeletes();	相当于为软删除添加一个可空的 deleted_at 字段
$table->softDeletesTz();	相当于为软删除添加一个可空的 带时区的 deleted_at 字段
$table->string('name', 100);	相当于带长度的 VARCHAR
$table->text('description');	相当于 TEXT
$table->time('sunrise');	相当于 TIME
$table->timeTz('sunrise');	相当于带时区的 TIME
$table->timestamp('added_on');	相当于 TIMESTAMP
$table->timestampTz('added_on');	相当于带时区的 TIMESTAMP
$table->timestamps();	相当于可空的 created_at 和 updated_at TIMESTAMP
$table->timestampsTz();	相当于可空且带时区的 created_at 和 updated_atTIMESTAMP
$table->tinyIncrements('id');	相当于自动递增 UNSIGNED TINYINT
$table->tinyInteger('votes');	相当于 TINYINT
$table->unsignedBigInteger('votes');	相当于 Unsigned BIGINT
$table->unsignedDecimal('amount', 8, 2);	相当于带有精度和基数的 UNSIGNED DECIMAL
$table->unsignedInteger('votes');	相当于 Unsigned INT
$table->unsignedMediumInteger('votes');	相当于 Unsigned MEDIUMINT
$table->unsignedSmallInteger('votes');	相当于 Unsigned SMALLINT
$table->unsignedTinyInteger('votes');	相当于 Unsigned TINYINT
$table->uuid('id');	相当于 UUID
$table->year('birth_year');	相当于 YEAR

可用的修饰符

 

Modifier	Description
->after('column')	将此字段放置在其它字段 "之后" (MySQL)
->autoIncrement()	将 INTEGER 类型的字段设置为自动递增的主键
->charset('utf8')	指定一个字符集 (MySQL)
->collation('utf8_unicode_ci')	指定列的排序规则 (MySQL/SQL Server)
->comment('my comment')	为字段增加注释 (MySQL)
->default($value)	为字段指定 "默认" 值
->first()	将此字段放置在数据表的 "首位" (MySQL)
->nullable($value = true)	此字段允许写入 NULL 值（默认情况下）
->storedAs($expression)	创建一个存储生成的字段 (MySQL)
->unsigned()	设置 INTEGER 类型的字段为 UNSIGNED (MySQL)
->useCurrent()	将 TIMESTAMP 类型的字段设置为使用 CURRENT_TIMESTAMP 作为默认值
->virtualAs($expression)	创建一个虚拟生成的字段 (MySQL)

 

修改字段

在修改字段之前，请确保将 doctrine/dbal 依赖添加到 composer.json 文件中。Doctrine DBAL 库用于确定字段的当前状态， 并创建对该字段进行指定调整所需的 SQL 查询：composer require doctrine/dbal

更新字段属性语句：

 $table->string('name', 50)->change();

change 方法可以将现有的字段类型修改为新的类型或修改属性。

重命名字段语句：

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

删除字段语句：

$table->dropColumn('votes');

Command	Description
$table->dropRememberToken();	删除 remember_token字段。
$table->dropSoftDeletes();	删除 deleted_at 字段。
$table->dropSoftDeletesTz();	dropSoftDeletes() 方法的别名
$table->dropTimestamps();	删除 created_at 和 updated_at 字段。
$table->dropTimestampsTz();	dropTimestamps() 方法的别名。

 

创建索引

字段定义同时定义索引

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

定义完字段之后创建索引

$table->unique('email');

数组传递给索引方法来创建一个复合（或合成）索引：

$table->index(['account_id', 'created_at']);

Laravel 会自动生成一个合理的索引名称，但你也可以传递第二个参数来自定义索引名称：

$table->unique('email', 'unique_email');

命令	描述
$table->primary('id');	添加主键
$table->primary(['id', 'parent_id']);	添加复合键
$table->unique('email');	添加唯一索引
$table->index('state');	添加普通索引
$table->spatialIndex('location');	添加空间索引 ( SQLite 除外)