數據庫遷移 · laravel 5.4

<article><h1>Laravel 的數據庫遷移 Migrations</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#generating-migrations">生成遷移</a></li><li><a href="#migration-structure">遷移結構</a></li><li><a href="#running-migrations">運行遷移</a><ul><li><a href="#rolling-back-migrations">回滾遷移</a></li></ul></li><li><a href="#tables">數據表</a><ul><li><a href="#creating-tables">創建數據表</a></li><li><a href="#renaming-and-dropping-tables">重命名與刪除數據表</a></li></ul></li><li><a href="#columns">字段</a><ul><li><a href="#creating-columns">創建字段</a></li><li><a href="#column-modifiers">字段修飾</a></li><li><a href="#modifying-columns">修改字段</a></li><li><a href="#dropping-columns">移除字段</a></li></ul></li><li><a href="#indexes">索引</a><ul><li><a href="#creating-indexes">創建索引</a></li><li><a href="#dropping-indexes">刪除索引</a></li><li><a href="#foreign-key-constraints">外鍵約束</a></li></ul></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>數據庫遷移就像是數據庫的版本控制，可以讓你的團隊輕松修改并共享應用程序的數據庫結構。遷移通常會搭配上 Laravel 的數據庫結構構造器來讓你方便地構建數據庫結構。如果你曾經出現過讓同事手動在數據庫結構中添加字段的情況，數據庫遷移可以解決你這個問題。Laravel 的 <code class=" language-php">Schema</code> <a href="/docs/5.4/facades">facade</a> 對所有 Laravel 支持的數據庫系統提供了創建和操作數據表的相應支持。<a name="generating-migrations"></a><h2><a href="#generating-migrations">生成遷移</a></h2>使用 <code class=" language-php">make:migration</code> <a href="/docs/5.4/artisan">Artisan 命令</a> 來創建遷移：<pre class=" language-php"><code class=" language-php">php artisan make:migration create_users_table</code></pre>新的遷移文件將會被放置在 <code class=" language-php">database/migrations</code> 目錄中。每個遷移文件的名稱都包含了一個時間戳，以便讓 Laravel 確認遷移的順序。<code class=" language-php">--table</code> 和 <code class=" language-php">--create</code> 選項可用來指定數據表的名稱，或是該遷移被執行時會創建的新數據表。這些選項需在預生成遷移文件時填入指定的數據表：<pre class=" language-php"><code class=" language-php">php artisan make:migration create_users_table --create=users php artisan make:migration add_votes_to_users_table --table=users</code></pre>如果你想為生成的遷移指定一個自定義輸出路徑，則可以在運行 <code class=" language-php">make:migration</code> 命令時添加 <code class=" language-php">--path</code> 選項。提供的路徑必須是相對于應用程序的基本路徑。<a name="migration-structure"></a><h2><a href="#migration-structure">遷移結構</a></h2>一個遷移類會包含兩個方法： <code class=" language-php">up</code> 和 <code class=" language-php">down</code> 。 <code class=" language-php">up</code> 方法可為數據庫添加新的數據表、字段或索引，而 <code class=" language-php">down</code> 方法則是 <code class=" language-php">up</code> 方法的逆操作。你可以在這兩個方法中使用 Laravel 數據庫結構構造器來創建以及修改數據表。若要了解 <code class=" language-php">數據庫結構</code> 構造器中的所有可用方法，<a href="#creating-tables">可查閱它的文檔</a>。以下的遷移實例會創建一張 <code class=" language-php">flights</code> 數據表：<pre class=" language-php"><code class=" language-php"><?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'); } }</code></pre><a name="running-migrations"></a><h2><a href="#running-migrations">運行遷移</a></h2>使用 <code class=" language-php">migrate</code> Artisan 命令，來運行所有未運行過的遷移：<pre class=" language-php"><code class=" language-php">php artisan migrate</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 如果你使用的是 <a href="/docs/5.4/homestead">Homestead 虛擬機</a> ，你需要在虛擬機中執行以上命令。</blockquote><h4>在線上環境強制執行遷移</h4>一些遷移的操作是具有破壞性的，它們可能會導致數據丟失。為了保護線上環境的數據庫，系統會在這些命令被運行之前顯示確認提示。若要忽略此提示并強制運行命令，則可以使用 <code class=" language-php">--force</code> 標記：<pre class=" language-php"><code class=" language-php">php artisan migrate --force</code></pre><a name="rolling-back-migrations"></a><h3>回滾遷移</h3>若要回滾最后一次遷移，則可以使用 <code class=" language-php">rollback</code> 命令。此命令是對上一次執行的「批量」遷移回滾，其中可能包括多個遷移文件：<pre class=" language-php"><code class=" language-php">php artisan migrate:rollback</code></pre>在 <code class=" language-php">rollback</code> 命令后加上 <code class=" language-php">step</code> 參數，你可以限制回滾遷移的個數。例如，下面的命令將會回滾最后的 5 個遷移。<pre class=" language-php"><code class=" language-php">php artisan migrate:rollback --step=5</code></pre><code class=" language-php">migrate:reset</code> 命令可以回滾應用程序中的所有遷移：<pre class=" language-php"><code class=" language-php">php artisan migrate:reset</code></pre><h4>使用單個命令來執行回滾或遷移</h4><code class=" language-php">migrate:refresh</code> 命令不僅會回滾數據庫的所有遷移還會接著運行 <code class=" language-php">migrate</code> 命令。所以此命令可以有效的重新創建整個數據庫：<pre class=" language-php"><code class=" language-php">php artisan migrate:refresh // 刷新數據庫結構并執行數據填充 php artisan migrate:refresh --seed</code></pre>使用 <code class=" language-php">refresh</code> 命令并加上 <code class=" language-php">step</code> 參數，你也可以限制執行回滾和再遷移的個數。比如，下面的命令會回滾并再遷移最后的 5 個遷移：<pre class=" language-php"><code class=" language-php">php artisan migrate:refresh --step=5</code></pre><a name="tables"></a><h2><a href="#tables">數據表</a></h2><a name="creating-tables"></a><h3>創建數據表</h3>要創建一張新的數據表，可以使用 <code class=" language-php">Schema</code> facade 的 <code class=" language-php">create</code> 方法。<code class=" language-php">create</code> 方法接收兩個參數：第一個參數為數據表的名稱，第二個參數為一個 <code class=" language-php">閉包</code> ，此閉包會接收一個用于定義新數據表的 <code class=" language-php">Blueprint</code> 對象：<pre class=" language-php"><code class=" language-php">Schema::create('users', function (Blueprint $table) { $table->increments('id'); });</code></pre>當然，在創建數據表的時候，你也可以使用任何數據庫結構構造器的 <a href="#creating-columns">字段方法</a> 來定義數據表的字段。<h4>檢查數據表或字段是否存在</h4>你可以方便地使用 <code class=" language-php">hasTable</code> 和 <code class=" language-php">hasColumn</code> 方法來檢查數據表或字段是否存在：<pre class=" language-php"><code class=" language-php">if (Schema::hasTable('users')) { // } if (Schema::hasColumn('users', 'email')) { // }</code></pre><h4>數據庫連接與存儲引擎</h4>如果你想要在一個非默認的數據庫連接中進行數據庫結構操作，可以使用 <code class=" language-php">connection</code> 方法：<pre class=" language-php"><code class=" language-php">Schema::connection('foo')->create('users', function (Blueprint $table) { $table->increments('id'); });</code></pre>你可以在數據庫結構構造器上設置 <code class=" language-php">engine</code> 屬性來設置數據表的存儲引擎：<pre class=" language-php"><code class=" language-php">Schema::create('users', function (Blueprint $table) { $table->engine = 'InnoDB'; $table->increments('id'); });</code></pre><a name="renaming-and-dropping-tables"></a><h3>重命名與刪除數據表</h3>若要重命名一張已存在的數據表，可以使用 <code class=" language-php">rename</code> 方法：<pre class=" language-php"><code class=" language-php">Schema::rename($from, $to);</code></pre>要刪除已存在的數據表，可使用 <code class=" language-php">drop</code> 或 <code class=" language-php">dropIfExists</code> 方法：<pre class=" language-php"><code class=" language-php">Schema::drop('users'); Schema::dropIfExists('users');</code></pre><h4>重命名帶外鍵的數據表</h4>在重命名前，你需要檢查外鍵的約束涉及到的數據表名需要在遷移文件中顯式的提供，而不是讓 Laravel 按照約定來設置一個名稱。因為那樣會讓外鍵約束關聯到舊的數據表上。<a name="columns"></a><h2><a href="#columns">字段</a></h2><a name="creating-columns"></a><h3>創建字段</h3>使用 <code class=" language-php">Schema</code> facade 的 <code class=" language-php">table</code> 方法可以更新已有的數據表。如同 <code class=" language-php">create</code> 方法，<code class=" language-php">table</code> 方法會接收兩個參數：一個是數據表的名稱，另一個則是接收 <code class=" language-php">Blueprint</code> 實例的<code class=" language-php">閉包</code>。我們可以使用它來為數據表新增字段：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->string('email'); });</code></pre><h4>可用的字段類型</h4>數據庫結構構造器包含了許多字段類型，供你構建數據表時使用：<table><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code class=" language-php">$table->bigIncrements('id');</code></td><td>遞增 ID（主鍵），相當于「UNSIGNED BIG INTEGER」型態。</td></tr><tr><td><code class=" language-php">$table->bigInteger('votes');</code></td><td>相當于 BIGINT 型態。</td></tr><tr><td><code class=" language-php">$table->binary('data');</code></td><td>相當于 BLOB 型態。</td></tr><tr><td><code class=" language-php">$table->boolean('confirmed');</code></td><td>相當于 BOOLEAN 型態。</td></tr><tr><td><code class=" language-php">$table->char('name', 4);</code></td><td>相當于 CHAR 型態，并帶有長度。</td></tr><tr><td><code class=" language-php">$table->date('created_at');</code></td><td>相當于 DATE 型態</td></tr><tr><td><code class=" language-php">$table->dateTime('created_at');</code></td><td>相當于 DATETIME 型態。</td></tr><tr><td><code class=" language-php">$table->dateTimeTz('created_at');</code></td><td>DATETIME (帶時區) 形態</td></tr><tr><td><code class=" language-php">$table->decimal('amount', 5, 2);</code></td><td>相當于 DECIMAL 型態，并帶有精度與基數。</td></tr><tr><td><code class=" language-php">$table->double('column', 15, 8);</code></td><td>相當于 DOUBLE 型態，總共有 15 位數，在小數點后面有 8 位數。</td></tr><tr><td><code class=" language-php">$table->enum('choices', ['foo', 'bar']);</code></td><td>相當于 ENUM 型態。</td></tr><tr><td><code class=" language-php">$table->float('amount', 8, 2);</code></td><td>相當于 FLOAT 型態，總共有 8 位數，在小數點后面有 2 位數。</td></tr><tr><td><code class=" language-php">$table->increments('id');</code></td><td>遞增的 ID (主鍵)，使用相當于「UNSIGNED INTEGER」的型態。</td></tr><tr><td><code class=" language-php">$table->integer('votes');</code></td><td>相當于 INTEGER 型態。</td></tr><tr><td><code class=" language-php">$table->ipAddress('visitor');</code></td><td>相當于 IP 地址形態。</td></tr><tr><td><code class=" language-php">$table->json('options');</code></td><td>相當于 JSON 型態。</td></tr><tr><td><code class=" language-php">$table->jsonb('options');</code></td><td>相當于 JSONB 型態。</td></tr><tr><td><code class=" language-php">$table->longText('description');</code></td><td>相當于 LONGTEXT 型態。</td></tr><tr><td><code class=" language-php">$table->macAddress('device');</code></td><td>相當于 MAC 地址形態。</td></tr><tr><td><code class=" language-php">$table->mediumIncrements('id');</code></td><td>遞增 ID (主鍵) ，相當于「UNSIGNED MEDIUM INTEGER」型態。</td></tr><tr><td><code class=" language-php">$table->mediumInteger('numbers');</code></td><td>相當于 MEDIUMINT 型態。</td></tr><tr><td><code class=" language-php">$table->mediumText('description');</code></td><td>相當于 MEDIUMTEXT 型態。</td></tr><tr><td><code class=" language-php">$table->morphs('taggable');</code></td><td>加入整數 <code class=" language-php">taggable_id</code> 與字符串 <code class=" language-php">taggable_type</code>。</td></tr><tr><td><code class=" language-php">$table->nullableMorphs('taggable');</code></td><td>與 <code class=" language-php">morphs()</code> 字段相同，但允許為NULL。</td></tr><tr><td><code class=" language-php">$table->nullableTimestamps();</code></td><td>與 <code class=" language-php">timestamps()</code> 相同，但允許為 NULL。</td></tr><tr><td><code class=" language-php">$table->rememberToken();</code></td><td>加入 <code class=" language-php">remember_token</code> 并使用 VARCHAR(100) NULL。</td></tr><tr><td><code class=" language-php">$table->smallIncrements('id');</code></td><td>遞增 ID (主鍵) ，相當于「UNSIGNED SMALL INTEGER」型態。</td></tr><tr><td><code class=" language-php">$table->smallInteger('votes');</code></td><td>相當于 SMALLINT 型態。</td></tr><tr><td><code class=" language-php">$table->softDeletes();</code></td><td>加入 <code class=" language-php">deleted_at</code> 字段用于軟刪除操作。</td></tr><tr><td><code class=" language-php">$table->string('email');</code></td><td>相當于 VARCHAR 型態。</td></tr><tr><td><code class=" language-php">$table->string('name', 100);</code></td><td>相當于 VARCHAR 型態，并帶有長度。</td></tr><tr><td><code class=" language-php">$table->text('description');</code></td><td>相當于 TEXT 型態。</td></tr><tr><td><code class=" language-php">$table->time('sunrise');</code></td><td>相當于 TIME 型態。</td></tr><tr><td><code class=" language-php">$table->timeTz('sunrise');</code></td><td>相當于 TIME (帶時區) 形態。</td></tr><tr><td><code class=" language-php">$table->tinyInteger('numbers');</code></td><td>相當于 TINYINT 型態。</td></tr><tr><td><code class=" language-php">$table->timestamp('added_on');</code></td><td>相當于 TIMESTAMP 型態。</td></tr><tr><td><code class=" language-php">$table->timestampTz('added_on');</code></td><td>相當于 TIMESTAMP (帶時區) 形態。</td></tr><tr><td><code class=" language-php">$table->timestamps();</code></td><td>加入 <code class=" language-php">created_at</code> 和 <code class=" language-php">updated_at</code> 字段。</td></tr><tr><td><code class=" language-php">$table->timestampsTz();</code></td><td>加入 <code class=" language-php">created_at</code> and <code class=" language-php">updated_at</code> (帶時區) 字段，并允許為NULL。</td></tr><tr><td><code class=" language-php">$table->unsignedBigInteger('votes');</code></td><td>相當于 Unsigned BIGINT 型態。</td></tr><tr><td><code class=" language-php">$table->unsignedInteger('votes');</code></td><td>相當于 Unsigned INT 型態。</td></tr><tr><td><code class=" language-php">$table->unsignedMediumInteger('votes');</code></td><td>相當于 Unsigned MEDIUMINT 型態。</td></tr><tr><td><code class=" language-php">$table->unsignedSmallInteger('votes');</code></td><td>相當于 Unsigned SMALLINT 型態。</td></tr><tr><td><code class=" language-php">$table->unsignedTinyInteger('votes');</code></td><td>相當于 Unsigned TINYINT 型態。</td></tr><tr><td><code class=" language-php">$table->uuid('id');</code></td><td>相當于 UUID 型態。</td></tr></tbody></table><a name="column-modifiers"></a><h3>字段修飾</h3>除了上述的字段類型列表，還有一些其它的字段「修飾」，你可以將它增加到字段中。例如，若要讓字段「nullable」，那么你可以使用 <code class=" language-php">nullable</code> 方法：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->string('email')->nullable(); });</code></pre>以下列表為字段的可用修飾。此列表不包括 <a href="#creating-indexes">索引修飾</a>：<table><thead><tr><th>Modifier</th><th>Description</th></tr></thead><tbody><tr><td><code class=" language-php">->after('column')</code></td><td>將此字段放置在其它字段「之后」（僅限 MySQL）</td></tr><tr><td><code class=" language-php">->comment('my comment')</code></td><td>增加注釋</td></tr><tr><td><code class=" language-php">->default($value)</code></td><td>為此字段指定「默認」值</td></tr><tr><td><code class=" language-php">->first()</code></td><td>將此字段放置在數據表的「首位」（僅限 MySQL）</td></tr><tr><td><code class=" language-php">->nullable()</code></td><td>此字段允許寫入 NULL 值</td></tr><tr><td><code class=" language-php">->storedAs($expression)</code></td><td>創建一個存儲的生成字段（僅限 MySQL）</td></tr><tr><td><code class=" language-php">->unsigned()</code></td><td>設置 <code class=" language-php">integer</code> 字段為 <code class=" language-php">UNSIGNED</code></td></tr><tr><td><code class=" language-php">->virtualAs($expression)</code></td><td>創建一個虛擬的生成字段（僅限 MySQL）</td></tr></tbody></table><a name="changing-columns"></a> <a name="modifying-columns"></a><h3>修改字段</h3><h4>先決條件</h4>在修改字段之前，請務必在你的 <code class=" language-php">composer.json</code> 中增加 <code class=" language-php">doctrine/dbal</code> 依賴。Doctrine DBAL 函數庫被用于判斷當前字段的狀態以及創建調整指定字段的 SQL 查詢。<pre class=" language-php"><code class=" language-php">composer require doctrine/dbal</code></pre><h4>更新字段屬性</h4><code class=" language-php">change</code> 方法讓你可以修改一些已存在的字段類型，或修改字段屬性。比如，你可能想增加字符串字段的長度。想了解 <code class=" language-php">change</code> 方法如何使用，讓我們來把 <code class=" language-php">name</code> 字段的長度從 25 增加到 50 ：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->string('name', 50)->change(); });</code></pre>我們也能將字段修改為 nullable：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->string('name', 50)->nullable()->change(); });</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 下面的字段類型不能被「修改」: char，double，enum，mediumInteger，timestamp，tinyInteger，ipAddress，json，jsonb，macAddress，mediumIncrements，morphs，nullableMorphs，nullableTimestamps，softDeletes，timeTz，timestampTz，timestamps，timestampsTz，unsignedMediumInteger，unsignedTinyInteger，uuid。</blockquote><a name="renaming-columns"></a><h4>重命名字段</h4>要重命名字段，可使用數據庫結構構造器的 <code class=" language-php">renameColumn</code> 方法。在重命名字段前，請確保你的 <code class=" language-php">composer.json</code> 文件內已經加入 <code class=" language-php">doctrine/dbal</code> 依賴：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->renameColumn('from', 'to'); });</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> 數據表的 <code class=" language-php">enum</code> 字段暫時不支持修改字段屬性。</blockquote><a name="dropping-columns"></a><h3>移除字段</h3>要移除字段，可使用數據庫結構構造器的 <code class=" language-php">dropColumn</code> 方法。在刪除 SQLite 數據庫的字段前，你需要在 <code class=" language-php">composer.json</code> 文件中加入 <code class=" language-php">doctrine/dbal</code> 依賴并在終端執行 <code class=" language-php">composer update</code> 來安裝函數庫：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->dropColumn('votes'); });</code></pre>你可以傳遞多個字段的數組至 <code class=" language-php">dropCloumn</code> 方法來移除多個字段：<pre class=" language-php"><code class=" language-php">Schema::table('users', function (Blueprint $table) { $table->dropColumn(['votes', 'avatar', 'location']); });</code></pre><blockquote class="has-icon note"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></div> SQLite 數據庫并不支持在單個遷移中移除或修改多個字段。</blockquote><a name="indexes"></a><h2><a href="#indexes">索引</a></h2><a name="creating-indexes"></a><h3>創建索引</h3>數據庫結構構造器支持多種類型的索引。首先，讓我們先來看一個示例，其指定了字段的值必須是唯一的。你可以簡單的在字段定義之后鏈式調用 <code class=" language-php">unique</code> 方法來創建索引：<pre class=" language-php"><code class=" language-php">$table->string('email')->unique();</code></pre>此外，你也可以在定義完字段之后創建索引。例如：<pre class=" language-php"><code class=" language-php">$table->unique('email');</code></pre>你也可以傳遞一個字段的數組至索引方法來創建復合索引：<pre class=" language-php"><code class=" language-php">$table->index(['account_id', 'created_at']);</code></pre>Laravel 會自動生成一個合理的索引名稱，但你也可以使用第二個參數來自定義索引名稱:<pre class=" language-php"><code class=" language-php">$table->index('email', 'my_index_name');</code></pre><h4>可用的索引類型</h4><table><thead><tr><th>Command</th><th>Description</th></tr></thead><tbody><tr><td><code class=" language-php">$table->primary('id');</code></td><td>加入主鍵。</td></tr><tr><td><code class=" language-php">$table->primary(['first', 'last']);</code></td><td>加入復合鍵。</td></tr><tr><td><code class=" language-php">$table->unique('email');</code></td><td>加入唯一索引。</td></tr><tr><td><code class=" language-php">$table->unique('state', 'my_index_name');</code></td><td>自定義索引名稱。</td></tr><tr><td><code class=" language-php">$table->unique(['first', 'last']);</code></td><td>加入復合唯一鍵。</td></tr><tr><td><code class=" language-php">$table->index('state');</code></td><td>加入基本索引。</td></tr></tbody></table><h4>索引長度 & MySQL / MariaDB</h4>Laravel 默認使用 <code class=" language-php">utf8mb4</code> 字符，包括支持在數據庫存儲「表情」。如果你正在運行的 MySQL release 版本低于5.7.7 或 MariaDB release 版本低于10.2.2 ，為了MySQL為它們創建索引，你可能需要手動配置遷移生成的默認字符串長度，你可以通過調用 <code class=" language-php">AppServiceProvider</code> 中的 <code class=" language-php">Schema::defaultStringLength</code> 方法來配置它：<pre class=" language-php"><code class=" language-php">use Illuminate\Support\Facades\Schema; /** * 引導任何應用程序服務。 * * @return void */ public function boot() { Schema::defaultStringLength(191); }</code></pre>或者你可以為數據庫開啟 <code class=" language-php">innodb_large_prefix</code> 選項，有關如何正確開啟此選項的說明請查閱數據庫文檔。<a name="dropping-indexes"></a><h3>移除索引</h3>若要移除索引，則必須指定索引的名稱。Laravel 默認會自動給索引分配合理的名稱。其將數據表名稱、索引的字段名稱及索引類型簡單地連接在了一起。舉例如下：<table><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code class=" language-php">$table->dropPrimary('users_id_primary');</code></td><td>從「users」數據表移除主鍵。</td></tr><tr><td><code class=" language-php">$table->dropUnique('users_email_unique');</code></td><td>從「users」數據表移除唯一索引。</td></tr><tr><td><code class=" language-php">$table->dropIndex('geo_state_index');</code></td><td>從「geo」數據表移除基本索引。</td></tr></tbody></table>如果你對 <code class=" language-php">dropIndex</code> 傳參索引數組，默認的約定是索引名稱由數據庫表名字和鍵名拼接而成：<pre class=" language-php"><code class=" language-php">Schema::table('geo', function (Blueprint $table) { $table->dropIndex(['state']); // 移除索引 'geo_state_index' });</code></pre><a name="foreign-key-constraints"></a><h3>外鍵約束</h3>Laravel 也為創建外鍵約束提供了支持，用于在數據庫層中的強制引用完整性。例如，讓我們定義一個有 <code class=" language-php">user_id</code> 字段的 <code class=" language-php">posts</code> 數據表，<code class=" language-php">user_id</code> 引用了 <code class=" language-php">users</code> 數據表的 <code class=" language-php">id</code> 字段：<pre class=" language-php"><code class=" language-php">Schema::table('posts', function (Blueprint $table) { $table->integer('user_id')->unsigned(); $table->foreign('user_id')->references('id')->on('users'); });</code></pre>你也可以指定約束的「on delete」及「on update」：<pre class=" language-php"><code class=" language-php">$table->foreign('user_id') ->references('id')->on('users') ->onDelete('cascade');</code></pre>要移除外鍵，你可以使用 <code class=" language-php">dropForeign</code> 方法。外鍵約束與索引采用相同的命名方式。所以，我們可以將數據表名稱和約束字段連接起來，接著在該名稱后面加上「_foreign」后綴：<pre class=" language-php"><code class=" language-php">$table->dropForeign('posts_user_id_foreign');</code></pre>你也可以傳遞一個包含字段的數組，在移除的時候字段會按照慣例被自動轉換為對應的外鍵名稱：<pre class=" language-php"><code class=" language-php">$table->dropForeign(['user_id']);</code></pre>你可以在遷移文件里使用以下方法來開啟和關閉外鍵約束：<pre class=" language-php"><code class=" language-php">Schema::enableForeignKeyConstraints(); Schema::disableForeignKeyConstraints();</code></pre><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://laravel-china.org/users/5336">@em0t</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/5336_1470812559.jpeg?imageView2/1/w/100/h/100"></td><td>翻譯</td><td>coding is funny</td></tr></tbody></table></article>