PHP数据库迁移通过代码管理数据库变更，实现版本控制。它确保开发、测试、生产环境的数据库结构一致，提升团队协作与部署效率。主要方案有两种：一是使用Laravel等框架内置的迁移工具，通过Artisan命令生成、执行和回滚迁移文件，结合Schema构建器编写可读性强的PHP代码来定义结构变更，并支持数据填充；二是针对无框架或遗留项目，编写自定义PHP迁移脚本，利用PDO执行SQL文件，通过migrations表记录执行状态，实现迁移追踪。核心流程包括创建迁移文件、执行变更、回滚操作及数据填充。推荐使用框架工具，因其具备自动化、可回滚、事务安全等优势，能有效避免手动修改导致的环境不一致问题。在Laravel中，应遵循单一职责原则编写迁移，善用Schema构建器，分离结构与数据变更，并通过migrate:status检查状态，生产环境执行前务必备份数据库。对于自定义系统，需设计健壮的执行器，支持事务、回滚、日志和配置管理，同时注意幂等性、并发控制与版本冲突问题。总之，数据库迁移是现代PHP开发不可或缺的实践，保障了数据库变更的可追溯性、一致性与安全性。
PHP数据库迁移，简单来说，就是通过代码而非手动操作来管理数据库结构（Schema）和数据变更的过程。这就像是给数据库的每一次改动都拍了张照片，并按时间线进行版本控制。它能确保你的开发、测试、生产环境数据库结构始终保持一致，极大简化了团队协作和部署流程中的数据库管理难题。无论是使用现代PHP框架内置的迁移工具，还是编写自定义脚本，核心目的都是让数据库变更可追溯、可重复、可回滚，从而避免因环境差异或手动失误带来的各种问题。
解决方案
PHP数据库迁移通常有两种主要路径：利用成熟的PHP框架（如Laravel、Symfony、Yii）提供的内置迁移功能，或者在没有框架支持或遗留项目中编写自定义的PHP迁移脚本。
1. 框架内置迁移工具（推荐）
立即学习“PHP免费学习笔记（深入）”；
现代PHP框架几乎都集成了强大的数据库迁移工具，它们提供了一套规范化的流程来定义和执行数据库变更。
核心概念： 迁移文件是PHP类，每个文件代表一个独立的数据库变更（例如，创建表、添加列、修改索引等）。这些文件通常包含
up()
down()
工作流程示例（以Laravel为例）：
生成迁移文件： 使用Artisan命令生成一个新的迁移文件，文件内容会自动包含
up()
down()
php artisan make:migration create_users_table --create=users # 或者添加列 php artisan make:migration add_email_to_users_table --table=users
编写迁移逻辑： 在生成的迁移文件中，使用框架提供的Schema构建器来定义数据库变更。这比直接写SQL更安全、更具可读性，并且能够跨数据库类型工作。
// database/migrations/xxxx_xx_xx_xxxxxx_create_users_table.php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('email')->unique();
$table->timestamp('email_verified_at')->nullable();
$table->string('password');
$table->rememberToken();
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('users');
}
};执行迁移： 运行Artisan命令，框架会查找所有未执行的迁移文件并按顺序执行它们的
up()
php artisan migrate
回滚迁移： 如果需要撤销最近的迁移，可以执行回滚命令。
php artisan migrate:rollback // 回滚上一次执行的所有迁移 php artisan migrate:reset // 回滚所有迁移 php artisan migrate:refresh // 回滚所有迁移并重新执行
数据填充（Seeding）： 除了结构迁移，框架也提供了数据填充功能，用于在数据库中插入初始数据或测试数据。
php artisan db:seed php artisan db:seed --class=UserSeeder
2. 自定义PHP迁移脚本
对于没有使用大型框架的项目，或者需要处理一些非常规的数据库变更，我们可以编写纯PHP脚本来完成迁移。这通常涉及直接使用PDO连接数据库，并执行SQL语句。
核心思路：
migrations
.sql
migrations
简化版自定义脚本示例（PHP + PDO）： 假设你的项目有一个
migrations/
2023_10_27_100000_create_users_table.sql
// migrate.php (一个简单的命令行执行器)
<?php
// 数据库配置
$dsn = 'mysql:host=localhost;dbname=your_database;charset=utf8mb4';
$username = 'your_user';
$password = 'your_password';
try {
$pdo = new PDO($dsn, $username, $password, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
} catch (PDOException $e) {
die("数据库连接失败: " . $e->getMessage());
}
// 确保有一个表来记录已执行的迁移
$pdo->exec("CREATE TABLE IF NOT EXISTS migrations (
id INT AUTO_INCREMENT PRIMARY KEY,
migration VARCHAR(255) UNIQUE NOT NULL,
executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)");
$migrationsDir = __DIR__ . '/migrations';
$appliedMigrations = $pdo->query("SELECT migration FROM migrations")->fetchAll(PDO::FETCH_COLUMN);
$files = glob($migrationsDir . '/*.sql');
sort($files); // 确保按文件名（通常包含时间戳）顺序执行
echo "开始执行数据库迁移...\n";
foreach ($files as $file) {
$migrationName = basename($file);
if (in_array($migrationName, $appliedMigrations)) {
echo " - 跳过已执行迁移: " . $migrationName . "\n";
continue;
}
echo " - 正在执行迁移: " . $migrationName . "\n";
$sql = file_get_contents($file);
try {
$pdo->beginTransaction();
$pdo->exec($sql);
$stmt = $pdo->prepare("INSERT INTO migrations (migration) VALUES (?)");
$stmt->execute([$migrationName]);
$pdo->commit();
echo " 成功执行。\n";
} catch (PDOException $e) {
$pdo->rollBack();
echo " 执行失败: " . $e->getMessage() . "\n";
die("迁移中止！\n");
}
}
echo "所有迁移执行完毕。\n";
?>要运行这个脚本，只需在命令行执行
php migrate.php
每个
migrations/*.sql
-- 2023_10_27_100000_create_users_table.sql
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(255) NOT NULL,
email VARCHAR(255) UNIQUE NOT NULL,
password VARCHAR(255) NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);
-- 2023_10_27_100000_down.sql (可选的回滚文件)
-- DROP TABLE users;自定义脚本的复杂性在于你需要自己处理回滚逻辑、事务管理、文件加载顺序等，这远不如框架内置工具来得方便和健壮。
在我看来，数据库迁移工具不仅仅是一个技术上的辅助，它更是现代软件开发流程中不可或缺的一环，尤其在团队协作和持续集成/部署（CI/CD）的语境下。
首先，版本控制是其核心价值。想想看，如果没有迁移工具，数据库结构的变更就无法像代码一样被Git管理。每次有人修改了表结构，团队成员之间就得口头通知，或者通过文档传递SQL脚本。这种方式效率低下，且极易出错。迁移工具将数据库变更封装成代码，每次提交代码时，数据库变更也随之提交，实现了数据库和应用代码的同步版本控制。
其次，它解决了环境一致性的问题。开发、测试、生产环境的数据库结构往往因为手动操作而产生差异，导致“在我的机器上没问题”的尴尬局面。迁移工具确保了在任何环境下，只要执行相同的迁移命令，就能得到相同的数据库结构，这对于保证软件质量至关重要。
再者，团队协作效率的提升是显而易见的。当多个开发者同时工作时，每个人都可能需要修改数据库。如果没有迁移工具，冲突解决将是一场噩梦。迁移工具通过原子化的变更文件，让合并数据库变更变得像合并代码一样，虽然仍可能遇到冲突，但至少有明确的机制去处理。
最后，可回滚性和自动化部署也是关键优势。不小心部署了一个有问题的数据库变更？没关系，一个简单的回滚命令就能恢复到上一个稳定状态。在自动化部署流水线中，数据库迁移命令可以作为部署脚本的一部分自动执行，大大减少了人工干预和潜在的错误。
总的来说，迁移工具将数据库管理从一个手动的、易错的、难以追踪的环节，转化成一个自动化的、可控的、可追溯的工程实践，这对于任何追求效率和稳定性的项目来说都是非常值得投入的。
在Laravel中编写和执行数据库迁移，其实围绕着Artisan命令行工具展开，但要做到“高效”，除了掌握基本命令，还需要一些最佳实践和深入理解。
1. 明确迁移目的： 每次迁移都应该有一个清晰、单一的目的。例如，
create_users_table
users
add_email_to_users_table
users
2. 善用Schema构建器： Laravel的
Schema
Schema::create('table_name', function (Blueprint $table) { ... });Schema::table('table_name', function (Blueprint $table) { ... });Schema::dropIfExists('table_name');Schema::dropColumn('column_name');$table->unique('email');$table->index(['first_name', 'last_name']);
$table->foreignId('user_id')->constrained()->onDelete('cascade');3. up()
down()
up()
down()
up()
down()
up()
down()
// 示例：添加一个列
public function up(): void
{
Schema::table('users', function (Blueprint $table) {
$table->string('phone')->nullable()->after('email');
});
}
public function down(): void
{
Schema::table('users', function (Blueprint $table) {
$table->dropColumn('phone');
});
}注意： 如果
up()
down()
4. 数据迁移与Schema迁移分离： 如果你的迁移不仅涉及Schema变更，还需要对现有数据进行操作（例如，将一个旧列的数据格式化后存入新列），最好将数据操作放在独立的迁移文件或使用数据填充（Seeder）来完成。这有助于保持Schema迁移的纯粹性，也更容易测试和管理数据转换逻辑。
5. 灵活运用Artisan命令：
php artisan migrate
php artisan migrate --force
php artisan migrate:rollback
php artisan migrate:reset
php artisan migrate:refresh
reset
migrate
php artisan migrate:status
php artisan db:seed
6. 预防性措施： 在执行任何重要的数据库迁移之前，尤其是在生产环境，务必备份数据库。虽然迁移工具提供了回滚机制，但数据丢失的风险依然存在，备份是最后一道防线。此外，在开发过程中，经常运行
migrate:refresh --seed
通过这些实践，不仅能保证数据库变更的正确性，也能大大提升开发效率和团队协作的顺畅度。
在没有框架支持，或者处理遗留项目时，构建一套健壮的PHP自定义迁移系统确实需要一些设计考量。这不只是简单地执行SQL文件那么简单，还需要考虑版本管理、回滚、错误处理等。
1. 核心组件设计：
./database/migrations/
YYYY_MM_DD_HHMMSS_migration_name.php
.sql
migrations
id
migration_name
executed_at
_down.sql
down()
2. 迁移文件的编写：
你可以选择两种方式来编写迁移文件：
纯SQL文件： 简单直接，每个文件包含
CREATE TABLE
ALTER TABLE
-- ./database/migrations/2023_10_27_110000_create_products_table.sql
CREATE TABLE products (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(255) NOT NULL,
price DECIMAL(10, 2) NOT NULL,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);PHP文件封装SQL： 这种方式更灵活，可以在执行SQL之前或之后加入PHP逻辑，比如条件判断、数据转换等。
// ./database/migrations/2023_10_27_110000_create_products_table.php
<?php
return new class {
public function up(PDO $pdo): void
{
$pdo->exec("CREATE TABLE products (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(255) NOT NULL,
price DECIMAL(10, 2) NOT NULL,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
)");
}
public function down(PDO $pdo): void
{
$pdo->exec("DROP TABLE products");
}
};这种方式下，你的执行器需要能加载并调用这些PHP类或匿名类的方法。
3. 构建迁移执行器（示例）：
在前文的解决方案部分，我提供了一个简化的PHP脚本示例，它展示了如何扫描SQL文件并记录。要使其更健壮，可以考虑以下增强：
migrate
rollback
// 伪代码，在执行器中
try {
$pdo->beginTransaction();
// 执行SQL
$pdo->exec($sql);
// 记录到migrations表
$pdo->commit();
} catch (PDOException $e) {
$pdo->rollBack();
// 记录错误日志
throw $e; // 或者友好提示
}up
down
2023_10_27_110000_create_products_table_down.sql
down()
down()
migrations
down
migrations
4. 挑战与注意事项：
CREATE TABLE
DROP TABLE
CREATE TABLE IF NOT EXISTS
虽然自定义迁移系统的工作量不小，但它赋予你对数据库变更的完全控制权。对于特定需求或遗留项目，这可能是最合适的解决方案，因为它允许你根据项目的具体情况进行定制。
以上就是PHP数据库迁移工具使用_PHP迁移脚本编写与执行教程的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
950
收藏
