数据库结构和数据填充

• 介绍
• 迁移结构
  • 创建表
  • 重命名/删除表
  • 创建列
  • 修改列
  • 删除列
  • 创建索引
  • 删除索引
  • 外键约束
• 填充类结构
  • Calling additional seeders

介绍

迁移和填充文件允许您构建/修改和填充数据库表。 它们主要由插件更新文件使用，并与插件的版本历史配对。 所有类都存储在插件的updates目录中。 迁移应该讲述一个关于您的数据库历史的故事，这个故事可以向前和向后播放，以构建和拆除表格。

迁移结构

迁移文件应该定义一个扩展October\Rain\Database\Updates\Migration类的类，它包含两个方法：up和down。 up方法用于向数据库添加新的表，列或索引，而down方法是up的逆向操作。 在这两种方法中，您可以使用schema builder(表格一整天的人如果生成器) 来表达式创建和修改表。 例如，让我们看一下创建october_blog_posts表的示例迁移：

<?php namespace Acme\Blog\Updates;
use Schema;
use October\Rain\Database\Updates\Migration;
class CreatePostsTable extends Migration
{
    public function up()
    {
        Schema::create('october_blog_posts', function($table)
        {
            $table->engine = 'InnoDB';
            $table->increments('id');
            $table->string('title');
            $table->string('slug')->index();
            $table->text('excerpt')->nullable();
            $table->text('content');
            $table->timestamp('published_at')->nullable();
            $table->boolean('is_published')->default(false);
            $table->timestamps();
        });
    }
    public function down()
    {
        Schema::drop('october_blog_posts');
    }
}

创建表

要创建新的数据库表，请在Schemafacade上使用create方法。 create方法接受两个参数。 第一个是表的名称，而第二个是Closure，它接收用于定义新表的对象：

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

当然，在创建表时，您可以使用任何模式构建器的列方法 来定义表的列。

重命名/删除表

您可以使用hasTable和hasColumn方法轻松检查是否存在表或列：

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

连接和存储引擎

如果要对不是默认连接的数据库连接执行模式操作，请使用connection方法：

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

要为表设置存储引擎，请在架构构建器上设置engine属性：

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

重命名/删除表

要重命名现有数据库表，请使用rename方法：

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

要删除现有表，可以使用drop或dropIfExists方法：

Schema::drop('users');
Schema::dropIfExists('users');

创建列

要更新现有表，我们将在Schemafacade上使用table方法。 与create方法一样，table方法接受两个参数，即表的名称和一个Closure，它接收一个我们可以用来向表中添加列的对象：

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

可用的列类型

当然，schema生成器包含构建表时可能使用的各种列类型：

列修饰符

除了上面列出的列类型之外，还可以在添加列时使用其他几个列“修饰符”。 例如，要使列“可为空”，您可以使用nullable方法：

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

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

修改列

change方法允许您将现有列修改为新类型，或修改列的属性。 例如，您可能希望增加字符串列的大小。 使用change方法，让我们将name列的大小从25增加到50：

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

我们还可以将列修改为可为空：

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

重命名列

要重命名列，可以在Schema上使用renameColumn方法：

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

注意: 目前不支持使用enum列重命名表中的列。

删除列

要删除列，请使用Schema上的“dropColumn”方法：

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

您可以通过将列名组成的数组传递给dropColumn方法从表中删除多个列：

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

创建索引

架构构建器支持多种类型的索引。 首先，让我们看一个指定列的值应该是唯一的示例。 要创建索引，我们可以简单地将unique方法链接到列定义：

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

或者，您可以在定义列后创建索引。 例如：

$table->unique('email');

您甚至可以将一组列传递给索引方法以创建复合索引：

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

在大多数情况下，您应手动指定索引的名称作为第二个参数，以避免系统自动生成太长的索引：

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

可用的索引类型

删除索引

要删除索引，必须指定索引的名称。 如果没有手动指定名称，系统将自动生成一个名称，只需连接表名，索引列的名称和索引类型。 这里有些例子：

外键约束

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

Schema::table('posts', function ($table) {
    $table->integer('user_id')->unsigned();
    $table->foreign('user_id')->references('id')->on('users');
});

和刚才一样，您可以通过将第二个参数传递给foreign方法来手动指定约束的名称：

$table->foreign('user_id', 'user_foreign')
    ->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');

填充结构

与迁移文件一样，填充类默认只包含一个方法：run并应扩展Seeder类。 执行更新过程时会调用run方法。 在此方法中，您可以根据需要将数据插入数据库。 您可以使用查询构建器手动插入数据，也可以使用model classes。 在下面的示例中，我们将使用run方法中的User模型创建一个新用户：

<?php namespace Acme\Users\Updates;
use Seeder;
use Acme\Users\Models\User;
class SeedUsersTable extends Seeder
{
    public function run()
    {
        $user = User::create([
            'email'                 => 'user@example.com',
            'login'                 => 'user',
            'password'              => 'password123',
            'password_confirmation' => 'password123',
            'first_name'            => 'Actual',
            'last_name'             => 'Person',
            'is_activated'          => true
        ]);
    }
}

或者，使用Db::table 查询构建器 方法可以实现相同的目的：

public function run()
{
    $user = Db::table('users')->insert([
        'email'                 => 'user@example.com',
        'login'                 => 'user',
        [...]
    ]);
}

其他填充器

在DatabaseSeeder类中，您可以使用call方法来执行其他填充类。 使用call方法可以将数据库填充分解为多个文件，这样就不会有单个的填充类变得非常大。 只需传递您希望运行的填充类的名称：

/**
 * 执行数据库填充
 *
 * @return void
 */
public function run()
{
    Model::unguard();
    $this->call('Acme\Users\Updates\UserTableSeeder');
    $this->call('Acme\Users\Updates\PostsTableSeeder');
    $this->call('Acme\Users\Updates\CommentsTableSeeder');
}