如何在 PHP 中管理資料庫遷移-php教程-PHP中文網

How to Manage Database Migrations in PHP

如何在 PHP 中管理資料庫遷移

資料庫遷移是應用程式開發的重要組成部分，因為它們允許開發人員以一致和結構化的方式進行版本控制和管理資料庫架構的變更。在 PHP 中，管理資料庫遷移可以手動完成，但使用自動化流程的遷移工具更有效率且不易出錯。遷移工具提供了一種有組織的方式來處理架構更改，使資料庫與應用程式程式碼保持同步。

在本文中，我們將探討如何在 PHP 中管理資料庫遷移，包括流行函式庫的使用、最佳實務和實際範例。

1.什麼是資料庫遷移？

資料庫遷移是對資料庫模式變更進行版本控制（例如，建立、更新或刪除表和列）並以受控方式應用這些變更的方法。遷移允許團隊：

追蹤變更：遷移提供架構變更的版本化歷史記錄，讓團隊追蹤進行了哪些變更以及何時進行。
自動架構更新：遷移可以自動運行或使用單一命令運行，確保資料庫架構在所有環境（開發、暫存、生產）中以一致的方式更新。
復原變更：如果遷移出現問題，可以回滾，從而在開發和部署過程中提供安全性和靈活性。

2.為什麼遷移很重要？

一致性：確保開發團隊中的每個人都使用相同的資料庫架構。
自動化：遷移可以自動運行，減少更新期間的手動錯誤。
版本控制：遷移可以輕鬆追蹤資料庫架構隨時間的演進。
易於部署：遷移在部署過程中很有幫助，可以輕鬆地跨不同環境（本地、暫存、生產）部署和同步架構變更。

3.如何在 PHP 中管理遷移

在 PHP 中處理資料庫遷移的方法有多種，但最常見的方法是使用遷移函式庫。以下是如何使用流行的 PHP 庫（如 Phinx 和 Doctrine Migrations。

來完成此操作）

4.使用 Phinx 進行資料庫遷移

Phinx 是一種流行的 PHP 遷移工具，可讓您建立和執行資料庫遷移。它支援多種資料庫平台，例如 MySQL、PostgreSQL、SQLite 等。

第 1 步：透過 Composer 安裝 Phinx

要安裝 Phinx，您可以使用 Composer 將其新增為依賴項。

composer require robmorgan/phinx

登入後複製

第2步：設定檔

Phinx 需要設定檔（phinx.php 或 phinx.yml）來管理連線設定和其他設定選項。這是 phinx.php 中的範例配置：

<?php
return [
    'paths' => [
        'migrations' => 'db/migrations',
        'seeds' => 'db/seeds'
    ],
    'environments' => [
        'default' => 'development',
        'development' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'your_database_name',
            'user' => 'root',
            'pass' => '',
            'charset' => 'utf8',
        ],
        'production' => [
            'adapter' => 'mysql',
            'host' => 'production_host',
            'name' => 'your_production_database',
            'user' => 'prod_user',
            'pass' => 'prod_password',
            'charset' => 'utf8',
        ]
    ]
];

登入後複製

此配置設定兩個環境（開發和生產），Phinx 將在其中管理資料庫的遷移。

第 3 步：建立遷移

要建立遷移，您可以使用以下 Phinx 指令：

php vendor/bin/phinx create CreateUsersTable

登入後複製

此指令在 db/migrations 目錄中建立一個移轉檔。遷移文件將如下所示：

<?php

use Phinx\Migration\AbstractMigration;

class CreateUsersTable extends AbstractMigration
{
    public function change()
    {
        $table = $this->table('users');
        $table->addColumn('name', 'string')
              ->addColumn('email', 'string')
              ->create();
    }
}

登入後複製

此遷移會建立一個包含兩列的使用者表：姓名和電子郵件。

第 4 步：運行遷移

建立遷移後，您可以使用以下命令將遷移應用到資料庫：

php vendor/bin/phinx migrate

登入後複製

Phinx 將套用尚未運行的任何新遷移。您也可以指定特定環境：

php vendor/bin/phinx migrate -e production

登入後複製

第 5 步：回滾遷移

如果您需要撤銷遷移（例如，當您想要回滾變更時），Phinx 提供以下命令：

php vendor/bin/phinx rollback

登入後複製

如果需要，您也可以回滾到特定版本或步驟：

php vendor/bin/phinx rollback -t 20210101000000

登入後複製

此指令將移轉回滾到指定版本。

5.使用 Doctrine 遷移進行資料庫遷移

Doctrine Migrations 是另一種流行的資料庫遷移工具，特別是對於已經使用 Doctrine ORM 進行資料庫互動的專案。它直接與 Doctrine 集成，並提供一組用於管理遷移的命令。

第 1 步：安裝 Doctrine 遷移

composer require doctrine/migrations

登入後複製

第 2 步：設定 Doctrine 遷移

您需要設定一個設定檔（migrations.php）來定義資料庫連線和遷移路徑。

migrations.php 設定範例：

<?php
use Doctrine\DBAL\DriverManager;
use Doctrine\Migrations\Configuration\Configuration;
use Doctrine\Migrations\Tools\Console\Command;
use Doctrine\Migrations\Tools\Console\ConsoleRunner;

// Set up the database connection
$conn = DriverManager::getConnection([
    'url' => 'mysql://root:@localhost/your_database_name',
]);

// Set up the migrations configuration
$config = new Configuration($conn);
$config->setMigrationsNamespace('App\Migrations');
$config->setMigrationsDirectory('db/migrations');

// Create the migration tool
$console = ConsoleRunner::createApplication($config);
$console->run();

登入後複製

第 3 步：建立遷移

您可以使用 Doctrine CLI 產生遷移：

php vendor/bin/doctrine-migrations generate

登入後複製

這會在 db/migrations 目錄中建立一個遷移檔案。

第 4 步：運行遷移

要運行遷移，請使用：

php vendor/bin/doctrine-migrations migrate

登入後複製

此指令會將所有待處理的遷移套用到資料庫。

第 5 步：回滾遷移

要回滾遷移，請使用：

composer require robmorgan/phinx

登入後複製

如果需要，您可以指定要回滾到哪個遷移版本。

6. PHP 中管理遷移的最佳實務

版本控制：始終將移轉檔案提交至版本控制（例如 Git）。這確保您的團隊可以追蹤並應用相同的資料庫變更。
避免手動更改：避免直接在資料庫中進行手動更改。使用遷移來進行架構更改，以便對它們進行版本控制並且可以追蹤。
描述性移轉名稱：以描述性方式命名移轉文件，以便您可以輕鬆了解每個移轉的作用（例如，AddIndexToUsersTable 或 CreateProductsTable）。
測試遷移：在將遷移應用於生產之前，請務必在臨時或開發資料庫上測試遷移，以避免潛在問題。
保持小型且增量的遷移：避免大型、單一的遷移。相反，進行增量更改，因為這樣更容易調試和理解。