本文介绍了Laravel 的数据库迁移的方法,分享给大家,具体如下:
生成迁移
--table 和 --create 选项可用来指定数据表的名称,或是该迁移被执行时会创建的新数据表。这些选项需在预生成迁移文件时填入指定的数据表:
1
2
3
|
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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
<?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 方法来检查数据表或字段是否存在:
1
2
3
4
5
6
|
if (Schema::hasTable( 'users' )) { // } if (Schema::hasColumn( 'users' , 'email' )) { // } |
如果你想要在一个非默认的数据库连接中进行数据库结构操作,可以使用 connection 方法:
1
2
3
|
Schema::connection( 'foo' )->create( 'users' , function (Blueprint $table ) { $table ->increments( 'id' ); }); |
你可以在数据库结构构造器上设置 engine 属性来设置数据表的存储引擎:
1
2
3
4
|
Schema::create( 'users' , function (Blueprint $table ) { $table ->engine = 'InnoDB' ; $table ->increments( 'id' ); }); |
重命名与删除数据表
1
2
3
4
5
|
Schema::rename( $from , $to ); //重命名 //删除已存在的数据表 Schema::drop( 'users' ); Schema::dropIfExists( 'users' ); |
创建字段
1
2
3
|
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 型态。 |
字段修饰
1
2
3
|
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) |
字段更新
1
2
3
4
|
Schema::table( 'users' , function (Blueprint $table ) { $table ->string( 'phone' ,20)->change(); $table ->string( 'username' ,60)->->nullable()->change(); }); |
重命名字段
1
2
3
|
Schema::table( 'users' , function (Blueprint $table ) { $table ->renameColumn( 'from' , 'to' ); }); |
字段移除
1
2
3
|
Schema::table( 'users' , function (Blueprint $table ) { $table ->dropColumn([ 'last_ip' , 'last_login' ]); }); |
在使用字段更新,重命名字段,字段移除之前,请务必在你的 composer.json文件require键名中添加< "doctrine/dbal": "^2.5">值。然后composer update进行更新或
1
|
composer require doctrine/dbal |
创建索引
1
|
$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'); | 加入基本索引。 |
开启和关闭外键约束
1
2
|
Schema::enableForeignKeyConstraints(); Schema::disableForeignKeyConstraints(); |
运行迁移
1
|
php artisan migrate |
在线上环境强制执行迁移
1
|
php artisan migrate --force |
回滚迁移
若要回滚最后一次迁移,则可以使用 rollback 命令。此命令是对上一次执行的「批量」迁移回滚,其中可能包括多个迁移文件:
1
|
php artisan migrate:rollback |
在 rollback 命令后加上 step 参数,你可以限制回滚迁移的个数。例如,下面的命令将会回滚最后的 5 个迁移。
1
|
php artisan migrate:rollback --step=5 |
migrate:reset 命令可以回滚应用程序中的所有迁移:
1
|
php artisan migrate:reset |
使用单个命令来执行回滚或迁移
migrate:refresh 命令不仅会回滚数据库的所有迁移还会接着运行 migrate 命令。所以此命令可以有效的重新创建整个数据库:
1
2
3
|
php artisan migrate:refresh // 刷新数据库结构并执行数据填充 php artisan migrate:refresh --seed |
使用 refresh 命令并加上 step 参数,你也可以限制执行回滚和再迁移的个数。比如,下面的命令会回滚并再迁移最后的 5 个迁移:
1
|
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 又可以执行上面的命令了。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://my.oschina.net/zhiqiangwang/blog/1492411