数据库迁移与填充

数据库迁移

迁移就像是数据库的版本控制, 允许团队简单轻松的编辑并共享应用的数据库表结构，迁移通常和 Laravel 的 数据库结构生成器配合使用，让你轻松地构建数据库结构。如果你曾经试过让同事手动在数据库结构中添加字段，那么数据库迁移可以让你不再需要做这样的事情。

Laravel 的 Schema门面 对所有 Laravel 支持的数据库系统提供了创建和操作数据表的相应支持。

生成迁移

使用 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 add_votes_to_users_table --table=users

如果你想要指定生成迁移指定一个自定义输出路径，则可以在运行 make:migration 命令时添加 --path 选项，给定的路径必须是相对于应用程序的基本路径。

迁移结构

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

在这2个方法中都要用到Laravel 的 Schema 构建器来创建和修改表，

若要了解 Schema 生成器中的所有可用方法 ，可以查看它的文档。比如，创建 flights 表的简单示例:

<?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');
    }
}

运行迁移

使用 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 facade的 create 方法来创建新的数据库表。 create 方法接受两个参数：第一个参数为数据表的名称，第二个参数是 Closure ，此闭包会接收一个用于定义新数据表的 Blueprint 对象：

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

当然，在创建数据表的时候，可以使用任何数据库结构生成器的 字段方法 来定义数据表的字段。

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

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

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

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

数据库连接 & 表选项

如果要对非默认连接的数据库连接执行结构操作，可以使用 connection 方法：

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

你可以在数据库结构生成器上使用以下命令来定义表的选项：

重命名 / 删除数据表

若要重命名数据表，可以使用 rename 方法：

Schema::rename($from, $to);

删除数据表， 可使用 drop 或 dropIfExists 方法：

Schema::drop('users');

Schema::dropIfExists('users');

创建字段

使用 Schema facade 的 table 方法可以更新现有的数据表。如同 create 方法一样，table 方法会接受两个参数：一个是数据表的名称，另一个则是接收可以用来向表中添加字段的 Blueprint 实例的闭包：

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

可用的字段类型

数据库结构生成器包含构建表时可以指定的各种字段类型：

字段修饰

除了上述列出的字段类型之外， 还有几个可以在添加字段时使用的 修饰符 。例如，如果要把字段设置为 可空，就使用 nullable 方法：

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

以下是所有可用的字段修饰符的列表。此列表不包括 索引修饰符：

修改字段

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

composer require doctrine/dbal

更新字段属性

change 方法可以将现有的字段类型修改为新的类型或修改属性。 比如，你可能想增加。字符串字段的长度，可以使用 change 方法把 name 字段的长度从 25 增加到 50：

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

我们应该将字段修改为可空：

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

只有下面的字段类型能被 修改

bigInteger、 binary、 boolean、date、dateTime、dateTimeTz、decimal、integer、
json、 longText、mediumText、smallInteger、string、text、time、 
unsignedBigInteger、unsignedInteger and unsignedSmallInteger。

重命名字段

可以使用结构生成器上的 renameColumn 方法来重命名字段。在重命名字段前， 请确保你的 composer.json 文件内已经加入 doctrine/dbal 依赖：

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

当前不支持 enum 类型的字段重命名。

删除字段

可以使用结构生成器上的 dropColumn 方法来删除字段。 在从 SQLite 数据库删除字段前，你需要在 composer.json 文件中加入doctrine/dbal 依赖并在终端执行 composer update 来安装该依赖：

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

你可以传递一个字段数组给 dropColumn 方法来删除多个字段：

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

不支持在使用 SQLite 数据库时在单个迁移中删除或修改多个字段。

可用的命令别名

每个索引方法都可以接收一个可选的第二个参数来指定索引的名称。 如果省略，名称将从表和列的名称派生。

创建索引

结构生成器支持多种类型的索引。首先，先指定字段值唯一，即简单地在字段定义 之后链式调用 unique 方法来创建索引，例如：

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

或者，你也可以在定义完字段之后创建索引。例如：

$table->unique('email');

你甚至可以将数组传递给索引方法来创建一个复合（或合成）索引：

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

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

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

可用的索引类型

删除索引

若要移除索引， 则必须指定索引的名称。Laravel 默认会自动给索引分配合理的名称。其将数据表名称、索引的字段名称及索引类型简单地连接在了一起。举例如下：

如果将字段数组传递给 dropIndex 方法，会删除根据表名、字段和键类型生成的索引名称：

Schema::table('geo', function (Blueprint $table) {
    $table->dropIndex(['state']); // 删除索引 'geo_state_index'
});

外键约束

Laravel 还支持创建用于在数据库层中的强制引用完整性的外键约束。 例如，让我们在 posts 表上定义一个引用 users 表的 id 字段的 user_id 字段：

Schema::table('posts', function (Blueprint $table) {
    $table->integer('user_id')->unsigned();

    $table->foreign('user_id')->references('id')->on('users');
});

还可以为约束的 on delete 和 on update 属性指定所需的操作：

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

你可以使用 dropForeign 方法删除外键。外键约束采用的命名方式与索引相同。即，将数据表名称和约束的字段连接起来， 接着加上 _foreign 后缀：

$table->dropForeign('posts_user_id_foreign');

或者，你也可以传递一个字段数组，在删除的时候会按照约定自动转换为对应的外键名称：

$table->dropForeign(['user_id']);

你可以在迁移文件里使用以下方法来开启或关闭外键约束：

Schema::enableForeignKeyConstraints();

Schema::disableForeignKeyConstraints();

数据填充

Laravel 可以用 seed 类轻松地为数据库填充测试数据。所有的 seed 类都存放在 database/seeds 目录下。你可以任意为 seed 类命名，但是更应该遵守类似 UsersTableSeeder 的命名规范。Laravel 默认定义的一个 DatabaseSeeder 类。可以在这个类中使用 call 方法来运行其它的 seed 类从而控制数据填充的顺序。

编写 Seeders

运行 Artisan 命令make:seeder 生成 Seeder。由框架生成的 seeders 都将被放置在 database/seeds 目录下：

php artisan make:seeder UsersTableSeeder

在默认的 DatabaseSeeder 类中的 run 方法中添加一条数据插入语句：

<?php

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class DatabaseSeeder extends Seeder
{
    /**
     * 运行数据库填充。
     *
     * @return void
     */
    public function run()
    {
        DB::table('users')->insert([
            'name' => str_random(10),
            'email' => str_random(10).'@gmail.com',
            'password' => bcrypt('secret'),
        ]);
    }
}

使用模型工厂

手动为每个模型填充指定属性很麻烦。作为替代方案，你可以使用 model 工厂 轻松地生成大量数据库数据。

例如，创建 50 个用户并为每个用户创建关联：

/**
 * 运行数据库填充。
 *
 * @return void
 */
public function run()
{
    factory(App\User::class, 50)->create()->each(function ($u) {
        $u->posts()->save(factory(App\Post::class)->make());
    });
}

调用其它 Seeders

在 DatabaseSeeder 类中，你可以使用 call 方法来运行其它的 seed 类。使用 call 方法可以将数据填充拆分成多个文件，这样就不会使单个 seeder 变得非常大。只需简单传递要运行的 seeder 类名称即可：

/**
 * 运行数据库 seeds。
 *
 * @return void
 */
public function run()
{
    $this->call([
        UsersTableSeeder::class,
        PostsTableSeeder::class,
        CommentsTableSeeder::class,
    ]);
}

运行 Seeders

完成 seeder 类的编写之后，你可能需要使用 dump-autoload 命令重新生成 Composer 的自动加载器：

composer dump-autoload

接着就可以使用 Artisan 命令 db:seed 来填充数据库了。默认情况下，db:seed 命令将运行 DatabaseSeeder类，这个类可以用来调用其它 Seed 类。不过，你也可以使用 --class 选项来指定一个特定的 seeder 类：

php artisan db:seed

php artisan db:seed --class=UsersTableSeeder

你也可以使用 migrate:refresh 命令来填充数据库，该命令会回滚并重新运行所有迁移。这个命令可以用来重建数据库：

php artisan migrate:refresh --seed