Larevel—数据库迁移

数据库迁移

即数据库的版本控制，这种机制允许团队编辑并共享数据库表的结构，迁移通常使用Laravel的schema构建器结对，Schema门面提供了与数据库系统相关的创建和操纵表的支持

生成迁移

使用Artisan命令make:migration就可以创建一个新的迁移

php artisan make:migration create_users_table（自定义表名）

新的迁移文件位于database/migrations目录下，每个迁移文件都包含时间戳从而允许Laravel判断其顺序
--table,--create选项用来指定数据表的名称，以及该迁移执行时是否需要创建一个新的数据表

php artisan make:migration create_users_table –create=users
php artisan make:migration create_users_table –table=users

make migration --path可以指定生成迁移文件的目录，提供的目录应该位于应用根目录

迁移结构

生成的结构：

<?php

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

class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            //
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            //
        });
    }
}

迁移类包含两个方法：up，down。up方法用于新增表，列或者索引到数据库，而down方法就是up的逆操作,这两个方法都可以使用Schema构建器来创建和修改表

运行迁移

要运行应用中所有未执行的迁移，可以使用 Artisan 命令提供的 migrate 方法：

php artisan migrate

回滚迁移

想要回滚最新的一次迁移”操作“，可以使用rollback命令，这将会回滚最后一批运行的迁移，可能包含多个迁移文件：

php artisan migrate:rollback

可以通过 rollback 命令上提供的step选项来回滚指定数目的迁移，例如，下面的命令将会回滚最后五条迁移：

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选项，例如，下面的命令将会回滚或重建最后五条迁移：

php artisan migrate:refresh –step=5

删除所有表 & 迁移

migrate:fresh命令将会先从数据库中删除所有表然后执行migrate命令：

php artisan migrate:fresh
php artisan migrate:fresh –seed

数据表操作

创建表

Schema门面上的create方法用于创建新的数据表，接受两个参数，第一个是表名，第二个是获取用于定义新表的Blueprint对象的闭包

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

检查表/列是否存在

hasTable,hasColumn方法检查表或列是否存在：

if(Schema::hasTable('users')){
    //
}
if(Schema::hasColumn('age','name')){
    //
}

数据库连接&表选项

如果要在一个不是默认数据库的数据库上进行表结构操作，可以使用connection方法：

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

要设置表的存储引擎、字符编码等选项，可以在Schema构建器上使用如下命令：

命令	描述
$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方法接收两个参数：表名和获取用于添加列到表的Blueprint实例的闭包

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

可用的数据列类型

命令	描述
$table->bigIncrements(‘id’);	等同于自增 UNSIGNED BIGINT（主键）列
$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(‘level’, [‘easy’, ‘hard’]);	等同于 ENUM 类型列
$table->float(‘amount’, 8, 2);	等同于 FLOAT 类型列，带精度和总位数
$table->geometry(‘positions’);	等同于 GEOMETRY 类型列
$table->geometryCollection(‘positions’);	等同于 GEOMETRYCOLLECTION 类型列
$table->increments(‘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’);	等同于自增 UNSIGNED MEDIUMINT 类型列（主键）
$table->mediumInteger(‘numbers’);	等同于 MEDIUMINT 类型列
$table->mediumText(‘description’);	等同于 MEDIUMTEXT 类型列
$table->morphs(‘taggable’);	添加一个 UNSIGNED INTEGER 类型的 taggable_id 列和一个 VARCHAR 类型的 taggable_type 列
$table->multiLineString(‘positions’);	等同于 MULTILINESTRING 类型列
$table->multiPoint(‘positions’);	等同于 MULTIPOINT 类型列
$table->multiPolygon(‘positions’);	等同于 MULTIPOLYGON 类型列
$table->nullableMorphs(‘taggable’);	morphs() 列的 nullable 版本
$table->nullableTimestamps();	timestamps() 的别名
$table->point(‘position’);	等同于 POINT 类型列
$table->polygon(‘positions’);	等同于 POLYGON 类型列
$table->rememberToken();	等同于添加一个允许为空的 remember_token VARCHAR(100) 列
$table->smallIncrements(‘id’);	等同于自增 UNSIGNED SMALLINT （主键）类型列
$table->smallInteger(‘votes’);	等同于 SMALLINT 类型列
$table->softDeletes();	新增一个允许为空的 deleted_at TIMESTAMP 列用于软删除
$table->softDeletesTz();	新增一个允许为空的 deleted_at TIMESTAMP （带时区）列用于软删除
$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_at TIMESTAMP 类型列（带时区）
$table->tinyIncrements(‘numbers’);	等同于自增的 UNSIGNED TINYINT 类型列（主键）
$table->tinyInteger(‘numbers’);	等同于 TINYINT 类型列
$table->unsignedBigInteger(‘votes’);	等同于无符号的 BIGINT 类型列
$table->unsignedDecimal(‘amount’, 8, 2);	等同于 UNSIGNED DECIMAL 类型列，带有总位数和精度
$table->unsignedInteger(‘votes’);	等同于无符号的 INTEGER 类型列
$table->unsignedMediumInteger(‘votes’);	等同于无符号的 MEDIUMINT 类型列
$table->unsignedSmallInteger(‘votes’);	等同于无符号的 SMALLINT 类型列
$table->unsignedTinyInteger(‘votes’);	等同于无符号的 TINYINT 类型列
$table->uuid(‘id’);	等同于 UUID 类型列
$table->year(‘birth_year’);	等同于 YEAR 类型列

列修改器

在添加列的时候，还可以使用一些其他的列“修改器”，如：nullable允许列为空

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

可用的列修改器列表：

修改器	描述
->after(‘column’)	将该列置于另一个列之后 (MySQL)
->autoIncrement()	设置 INTEGER 列为自增主键
->charset(‘utf8’)	指定数据列字符集（MySQL）
->collation(‘utf8_unicode_ci’)	指定数据列字符序（MySQL/SQL Server）
->comment(‘my comment’)	添加注释信息
->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文件，在当前的Laravel框架下执行：

composer require doctrine/dbal

更新数据列
change方法用于修改已存在的列为新类型，或者修改列的属性

Schema::table('users',function(Blueprint $table)
{
    //将name列尺寸从25增加到50且为varchar类型
    $table->string('name',50)->change();
    //将该列修改成允许为空
    $table->string('name',50)->nullable()->change();
});

重命名列

renameColumn方法用于重命名一个列（使用之前需要添加doctrine/dbal依赖，并运行composer update命令）

Schema::table('users',function(Blueprint $table)
{
    $table->renameColumn('form','to');
});

删除数据列

dropColumn方法用于删除一个列，同样需要doctrine/dbal依赖

Schema::table('users',function(Blueprint $table)
{
    $table->dropColumn(['votes','avatar','location']);
});

索引操作

创建索引

unique方法用于创建唯一值索引
两种方法：

$table->string(‘email’)->unique();
$table->unique(‘email’)

还可以通过传递数组创建组合索引：

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

Laravel会自动生成合理的索引名，也可以通过第二个参数自定义索引名称：

$table->index(‘email’,’unique_enail’);

可用的索引类型

命令	描述
$table->primary(‘id’);	添加主键索引
$table->primary([‘id’, ‘parent_id’]);	添加组合索引
$table->unique(‘email’);	添加唯一索引
$table->index(‘state’);	添加普通索引
$table->spatialIndex(‘location’);	添加空间索引（不支持SQLite）

删除索引

删除索引要指定索引名，默认情况下，Laravel自动分配适当的名称给索引

命令	描述
$table->dropPrimary(‘users_id_primary’);	从 “users” 表中删除主键索引
$table->dropUnique(‘users_email_unique’);	从 “users” 表中删除唯一索引
$table->dropIndex(‘geo_state_index’);	从 “geo” 表中删除普通索引
$table->dropSpatialIndex(‘geo_location_spatialindex’);	从 “geo” 表中删除空间索引（不支持SQLite）

外键约束

foreign，reference，on方法用于设置外键约束

//在posts表中定义一个引用usee表id列的user_id列
Schema::table('posts',function(Blueprint $table)
{
    $table->integer('user_id')->unsigned();
    $table->foreign('user_id')->reference('id')->on('users');
});

还可以为约束的“on delete”,”on update”属性指定期望的动作：

$table->foreign('user_id')
      ->reference('id')->on('users')
      ->onDelete('cascade');

dropForeign方法用于删除一个外键，外键约束和索引使用同样的命名规则：**连接表名、外键名、_foreign/_index后缀：

$table->dropForeign(‘posts_user_id_foreign’);

在迁移时通过以下方法启用或关闭外键约束：

Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();

使用数据库迁移的流程：

1. 当从git等拿到Laravel项目后，使用php artisan migrate运行生成数据库
2. 在本地更改数据库结构，使用php artisan make migrate 表名生成迁移文件
3. 两种管理方法：
   (1). 在up方法里用create直接创建新的表，然后在down中使用drop把原表删除，弊端在于所有表数据都会失去
   (2). 在up里面使用判断，修改已存在的表则使用tabel方法，down方法不使用
4. 在本地生成新的表结构后，使用php artisan migrate:refresh重新生成本地表结构