如何在 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）。
测试迁移：在将迁移应用于生产之前，始终在临时或开发数据库上测试迁移，以避免潜在问题。
保持小型且增量的迁移：避免大型、单一的迁移。相反，进行增量更改，因为这样更容易调试和理解。