核心要點(diǎn)

• Ladder 是一款用于創(chuàng)建、運(yùn)行和管理數(shù)據(jù)庫(kù)遷移的工具，它允許以與應(yīng)用程序代碼相同的方式跟蹤數(shù)據(jù)庫(kù)模式的更改。此工具可以集成到任何主要框架中，并可用于版本控制中的更改和功能管理。
• 遷移始終按順序運(yùn)行，Ladder 通過(guò)按順序編號(hào)遷移并在數(shù)據(jù)庫(kù)本身中存儲(chǔ)已運(yùn)行遷移的記錄來(lái)確保這一點(diǎn)，從而防止重新運(yùn)行以前的遷移。
• Ladder 還允許預(yù)填充或“播種”數(shù)據(jù)庫(kù)，從而能夠創(chuàng)建默認(rèn)數(shù)據(jù)集，例如默認(rèn)用戶帳戶。這可以使用 Ladder 的鍵值存儲(chǔ)來(lái)完成，將某些數(shù)據(jù)存儲(chǔ)起來(lái)以便以后參考。
• 該工具提供其他命令來(lái)管理和監(jiān)控?cái)?shù)據(jù)庫(kù)，例如用于數(shù)據(jù)庫(kù)狀態(tài)的 status 命令、用于轉(zhuǎn)儲(chǔ)和恢復(fù)數(shù)據(jù)庫(kù)狀態(tài)的 diff 和 diff-save 命令，以及用于檢查所用 Ladder 版本的 version 命令。

版本控制系統(tǒng)對(duì)于跟蹤代碼中的更改非常寶貴，尤其是在團(tuán)隊(duì)合作時(shí)。但是，大多數(shù)應(yīng)用程序不僅僅包含應(yīng)用程序代碼。管理數(shù)據(jù)庫(kù)的更改一直更具挑戰(zhàn)性，尤其是在添加需要更改模式的新功能時(shí)。

假設(shè)您正在處理一個(gè)模塊，并且意識(shí)到一個(gè)數(shù)據(jù)庫(kù)表需要一個(gè)額外的列。您可能會(huì)想打開一個(gè)數(shù)據(jù)庫(kù)查詢工具或命令行，然后簡(jiǎn)單地添加該列。但是，這不會(huì)像版本控制的應(yīng)用程序代碼那樣留下更改記錄。在團(tuán)隊(duì)合作時(shí)，這種情況會(huì)加劇——如果同事在沒(méi)有運(yùn)行相同的數(shù)據(jù)庫(kù)更新的情況下提取您的代碼更改，那么他們的應(yīng)用程序版本很可能會(huì)崩潰。當(dāng)您發(fā)布產(chǎn)品更新時(shí)，這會(huì)變得更加成問(wèn)題，因?yàn)檫@可能會(huì)破壞不僅僅是您同事的應(yīng)用程序，還會(huì)破壞您的用戶的應(yīng)用程序。

一種解決方案是使用遷移將創(chuàng)建和修改數(shù)據(jù)庫(kù)模式的責(zé)任轉(zhuǎn)移到代碼中。這樣，就可以與應(yīng)用程序的其余部分一起管理更改，并且我們可以利用版本控制中我們習(xí)以為常的功能（例如能夠比較版本并保留審計(jì)跟蹤）來(lái)處理數(shù)據(jù)庫(kù)更改。它還允許這些更改無(wú)縫地集成到版本中，因?yàn)樗鼈兛梢猿蔀橥环种Щ驑?biāo)簽的一部分。

許多主要框架都有自己的遷移實(shí)現(xiàn)，但對(duì)于那些沒(méi)有的框架——如果您沒(méi)有使用任何框架——可以使用 Ladder。

Ladder 簡(jiǎn)介

Ladder 是一款用于創(chuàng)建、運(yùn)行和管理數(shù)據(jù)庫(kù)遷移的工具。遷移只是一個(gè) PHP 類，因此可以與應(yīng)用程序的其余代碼一起簽入版本控制。

您可以在單個(gè)遷移中對(duì)模式進(jìn)行任意多的更改，盡管最好將遷移限制為單個(gè)表或功能。

遷移始終按順序運(yùn)行。因此，假設(shè)您編寫一個(gè)用于創(chuàng)建 products 表的遷移，并且?guī)字芎髣?chuàng)建一個(gè)新的遷移來(lái)向其中添加一個(gè)額外的列。嘗試在后者之前運(yùn)行前者將產(chǎn)生錯(cuò)誤。Ladder 通過(guò)按順序編號(hào)遷移以及在數(shù)據(jù)庫(kù)本身中存儲(chǔ)已運(yùn)行遷移的記錄（以及時(shí)間）來(lái)解決此問(wèn)題。

安裝

Ladder 可以從 Bitbucket 或通過(guò) Composer 下載。但是，需要幾個(gè)步驟才能啟動(dòng)并運(yùn)行。

最簡(jiǎn)單的方法（盡管承認(rèn)不那么優(yōu)雅）是從下載或克隆它，并將其放在項(xiàng)目根目錄中名為 ladder 的目錄中。使用 Composer 的問(wèn)題是運(yùn)行 composer update 將覆蓋您的配置文件。

有五個(gè)配置文件，每個(gè)配置文件都需要手動(dòng)創(chuàng)建；最簡(jiǎn)單的方法是復(fù)制提供的示例：

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

您可能只需要修改 database.php（其中包含數(shù)據(jù)庫(kù)連接詳細(xì)信息）和 editor.php，您可以在其中指定首選文本編輯器，以及選擇在創(chuàng)建時(shí)自動(dòng)打開新的遷移。

創(chuàng)建遷移

讓我們從創(chuàng)建一個(gè)遷移來(lái)創(chuàng)建 users 表開始。

在命令行上：

php ladder/ladder.php create create_users_table

這將創(chuàng)建一個(gè)名為 ladder/migrations/00001_create_users_table 的文件，默認(rèn)情況下，該文件包含一個(gè)帶有注釋掉的示例調(diào)用的基本結(jié)構(gòu)。如果您已在 ladder/config/editor.php 中將 auto-edit 設(shè)置為 true，則此文件將立即在指定的文本編輯器中打開。您可以隨意調(diào)用遷移，但能夠一目了然地從文件名中看到遷移的作用會(huì)有所幫助。

以下是該文件可能的樣子（為了清晰起見(jiàn)，我刪除了已注釋掉的代碼行）：

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

當(dāng)運(yùn)行遷移時(shí)調(diào)用 up() 方法，當(dāng)回滾遷移時(shí)調(diào)用 down() 方法——因此它始終需要執(zhí)行與 up() 方法相反的操作。在此示例中，up() 方法創(chuàng)建一個(gè)名為 users 的表，而 down() 方法將其刪除。

create_table() 方法返回對(duì)新表的引用，而 Table 類具有一個(gè) column() 方法來(lái)添加新列。它具有流暢的接口，因此您可以將它們鏈接在一起以同時(shí)創(chuàng)建多個(gè)列。您會(huì)注意到?jīng)]有 ID 列——這是自動(dòng)創(chuàng)建的——即名為 id 的自動(dòng)遞增整數(shù)主鍵。

table() 返回對(duì)表的引用，但如果表尚不存在，它也會(huì)創(chuàng)建表——因此，您可以安全地將 create_table() 調(diào)用更改為 table()

讓我們創(chuàng)建另一個(gè)遷移，這次是創(chuàng)建 roles 表：

php ladder/ladder.php create create_roles_table

文件本身：

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

現(xiàn)在您需要實(shí)際運(yùn)行遷移。為此：

php ladder/ladder.php migrate

如果您查看數(shù)據(jù)庫(kù)，您會(huì)發(fā)現(xiàn)四個(gè)表：

migrations 是自動(dòng)創(chuàng)建的，用于跟蹤已運(yùn)行哪些遷移 migrations_kvdata 也是為您創(chuàng)建的，您的遷移可以使用它進(jìn)行任意鍵值存儲(chǔ) users 和 roles 是我們剛剛添加的表。

但是，如果您仔細(xì)注意 roles 遷移，您會(huì)注意到它創(chuàng)建了一個(gè)名為 nme 而不是 name 的列。此時(shí)，我們可以通過(guò)“撤消”遷移、修改類然后再次運(yùn)行它來(lái)修復(fù)此問(wèn)題。要回滾遷移：

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

數(shù)字 2 表示要回滾到的遷移——它是遷移文件名的前綴，沒(méi)有前導(dǎo)零。

現(xiàn)在您可以簡(jiǎn)單地進(jìn)行更正，然后再次運(yùn)行遷移：

php ladder/ladder.php create create_users_table

因?yàn)?migrations 表已存儲(chǔ)運(yùn)行和未運(yùn)行內(nèi)容的記錄，所以您無(wú)需擔(dān)心您的第一次遷移將被重新運(yùn)行。

還有一種更快的方法，可以使用 reapply：

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

這將一次性調(diào)用第二個(gè)遷移的 down() 方法，然后調(diào)用其 up() 方法。

現(xiàn)在假設(shè)一段時(shí)間后，我們開發(fā)了一個(gè)新功能，該功能要求 users 表包含一個(gè) status 字段。為此，我們需要?jiǎng)?chuàng)建一個(gè)新的遷移：

php ladder/ladder.php create create_roles_table

遷移將如下所示：

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

和以前一樣，使用以下命令運(yùn)行：

php ladder/ladder.php migrate

現(xiàn)在，如果您檢查您的數(shù)據(jù)庫(kù)，您會(huì)看到 users 表有一個(gè)新列。

數(shù)據(jù)庫(kù)播種

除了編寫遷移來(lái)管理數(shù)據(jù)庫(kù)模式外，您還可以使用 Ladder 來(lái)預(yù)填充（即播種）數(shù)據(jù)庫(kù)。

例如，您可以擴(kuò)展 create_users_table 遷移以創(chuàng)建默認(rèn)的 root 用戶帳戶：

php ladder/ladder.php remove 2

請(qǐng)注意，我們正在使用 set() 和 get() 方法來(lái)利用 Ladder 的鍵值存儲(chǔ)，存儲(chǔ)用戶 ID 以便我們以后可以引用它。

您還可以從遷移中的 CSV 文件導(dǎo)入數(shù)據(jù)，例如：

php ladder/ladder.php migrate

要更新而不是插入 CSV 數(shù)據(jù)，您可以這樣做：

php ladder/ladder.php reapply 2

在這種情況下，send 參數(shù)表示我們要運(yùn)行 UPDATE，第三個(gè)參數(shù)包含用于確定要更新哪些記錄的關(guān)鍵字段列表。

添加其他數(shù)據(jù)庫(kù)

您會(huì)注意到默認(rèn)數(shù)據(jù)庫(kù)配置文件 ladder/config/database.php 演示了如何添加其他數(shù)據(jù)庫(kù)連接；也許用于登臺(tái)或?qū)崟r(shí)數(shù)據(jù)庫(kù)。例如：

php ladder/ladder.php create add_status_to_users_table

您可以像這樣指定要使用的連接：

class Add_Status_To_Users_Table_Migration_00003 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('users')
            ->column('status', 'integer', array('null' => FALSE, 'default' => 0));            
    }

    public function down() {
        $this->table('users')->drop_column('status');      
    }
}

其他命令

狀態(tài)

您可以使用 status 命令獲取數(shù)據(jù)庫(kù)的狀態(tài)：

php ladder/ladder.php migrate

示例輸出：（此處省略示例輸出，因?yàn)樵臋n中沒(méi)有提供具體的輸出內(nèi)容）

diff 和 diff-save

（此處省略 diff 和 diff-save 命令的描述，因?yàn)樵臋n中已經(jīng)詳細(xì)描述了這些命令）

版本

（此處省略 version 命令的描述，因?yàn)樵臋n中已經(jīng)詳細(xì)描述了該命令）

總結(jié)

本文介紹了 Ladder，用于維護(hù)數(shù)據(jù)庫(kù)模式和預(yù)填充數(shù)據(jù)。（此處省略總結(jié)部分，因?yàn)樵臋n已經(jīng)對(duì)Ladder進(jìn)行了總結(jié)）

數(shù)據(jù)庫(kù)版本控制和 Ladder 遷移的常見(jiàn)問(wèn)題

（此處省略常見(jiàn)問(wèn)題解答部分，因?yàn)樵臋n已經(jīng)提供了詳細(xì)的常見(jiàn)問(wèn)題解答）

以上是帶有梯子遷移的數(shù)據(jù)庫(kù)版本控制的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！