（2）字段操作 · Laravel 5.5 学习笔记

[TOC] ## 字段创建 `CreateUsersTable` 类中通过 `Blueprint` 实例 `$table` 为 users 表创建所需的字段： > 由 `increments` 方法创建一个` integer` 类型的自增长 id。 ~~~php $table->increments('id'); ~~~ > 由 `string` 方法创建一个 `name` 字段，用于保存用户名称。 ~~~php $table->string('name'); ~~~ > 由 `string` 方法创建一个 `email` 字段，且在最后指定该字段的值为唯一值，用于保存用户邮箱。 ~~~php $table->string('email')->unique(); ~~~ > 由 `string` 方法创建一个 `password` 字段，且在 `string` 方法中指定保存的值最大长度为 60，用于保存用户密码。 ~~~php $table->string('password', 60); ~~~ > 由 `rememberToken` 方法为用户创建一个 `remember_token` 字段，用于保存『记住我』的相关信息。 ~~~php $table->rememberToken(); ~~~ > 由 `timestamps` 方法创建了一个 `created_at` 和一个 `updated_at` 字段，分别用于保存用户的创建时间和更新时间。 ~~~php $table->timestamps(); ~~~ >[info] 该迁移文件最终生成的数据表如下：字段名称 | 字段类型 ------------- | ------------- id | integer name | string email | string password | string remember_token | string created_at | datetime updated_at | datetime ### 可用的字段类型命令 | 描述 ------------- | ------------- `$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 型态。 ### 可用的字段修饰除了上述的字段类型列表，还有一些其它的字段「修饰」，你可以将它增加到字段中。例如，若要让字段「nullable」，那么你可以使用 `nullable` 方法： ~~~php Schema::table('users', function (Blueprint $table) { $table->string('email')->nullable(); }); ~~~ 修饰 | 描述 ------------- | ------------- `->after('column')` | 将此字段放置在其它字段「之后」（仅限 MySQL） `->comment('my comment')` | 增加注释 `->default($value)` | 为此字段指定「默认」值 `->first()` | 将此字段放置在数据表的「首位」（仅限 MySQL） `->nullable()` | 此字段允许写入 NULL 值 `->storedAs($expression)` | 创建一个存储的生成字段（仅限 MySQL） `->unsigned()` | 设置 `integer` 字段为 `UNSIGNED` `->virtualAs($expression)` | 创建一个虚拟的生成字段（仅限 MySQL） >[warning] 此列表不包括 [索引修饰](database/indexes.md) ## 字段修改 ### 先决条件 >[danger] 在修改字段之前，请**务必**在你的 `composer.json` 中增加 `doctrine/dbal` 依赖。 >[info] Doctrine DBAL 函数库：用来判断当前字段的状态，以及创建调整指定字段的 SQL 查询。 ~~~shell $ composer require doctrine/dbal // 或修改 composer.json 文件后执行 $ composer update ~~~ ### 更改字段类型或属性：实例 `$table` 的 `change` 方法例子： 1. 增加字符串字段的长度，把 `name` 字段的长度从 25 增加到 50 ： ~~~php Schema::table('users', function (Blueprint $table) { $table->string('name', 50)->change(); }); ~~~ 2. 将字段修改为 nullable： ~~~php Schema::table('users', function (Blueprint $table) { $table->string('name', 50)->nullable()->change(); }); ~~~ >[danger] 下面的字段类型不能被「修改」: char，double，enum，mediumInteger，timestamp，tinyInteger，ipAddress，json，jsonb，macAddress，mediumIncrements，morphs，nullableMorphs，nullableTimestamps，softDeletes，timeTz，timestampTz，timestamps，timestampsTz，unsignedMediumInteger，unsignedTinyInteger，uuid。 ### 重命名字段：实例 `$table` 的 `renameColumn` 方法 ~~~php Schema::table('users', function (Blueprint $table) { $table->renameColumn('from', 'to'); }); ~~~ ### 删除字段：实例 `$table` 的 `dropColumn` 方法 ~~~php Schema::table('users', function (Blueprint $table) { $table->dropColumn('votes'); }); ~~~ #### 删除多个字段：传递多个字段的数组至 `dropCloumn` 方法 ~~~php Schema::table('users', function (Blueprint $table) { $table->dropColumn(['votes', 'avatar', 'location']); }); ~~~ >[warning] SQLite 数据库不支持在单个迁移中删除或修改多个字段。 #### 可用的删除命令命令 | 描述 --- | --- `$table->dropRememberToken();` | 删除 `remember_token` 字段。 `$table->dropSoftDeletes();` | 删除用于软删除操作 `deleted_at` 字段。 `$table->dropSoftDeletesTz();` | 删除 `deleted_at` 字段。 `$table->dropTimestamps();` | 删除 `created_at` 和 `updated_at` 字段。 `$table->dropTimestampsTz();` | 删除 `created_at` 和 `updated_at` 字段。