PHP应用部署：MySQL表不存在则创建，缺失列自动补充方案

针对你这种PHP应用频繁更新、需要动态处理缺失表/列的场景，我分享几个实用的半自动化思路，既能适配后续持续变更的表结构，又不用每次手动操作数据库：

核心思路：版本化迁移脚本 #

最稳妥的方式是给每次数据库变更写一个版本化的迁移脚本，脚本里包含「检查对象是否存在→执行创建/修改」的逻辑，然后通过一个统一的入口执行未运行过的脚本。这种方式既能追溯变更历史，又能避免重复执行。

具体实现细节 #

1. 工具函数：检查表/列是否存在 #

先封装两个基础函数，用来判断表或列是否已经存在，确保脚本是幂等的（多次执行不会报错）：

// 检查指定表是否存在
function tableExists($pdo, $tableName) {
    $stmt = $pdo->prepare("SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ?");
    $stmt->execute([$tableName]);
    return $stmt->rowCount() > 0;
}

// 检查指定表的列是否存在
function columnExists($pdo, $tableName, $columnName) {
    $stmt = $pdo->prepare("SELECT 1 FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ? AND COLUMN_NAME = ?");
    $stmt->execute([$tableName, $columnName]);
    return $stmt->rowCount() > 0;
}

2. 编写迁移脚本（以你的comments表为例） #

给每个数据库变更写一个单独的脚本，命名带上时间戳（确保执行顺序），比如20240520_create_comments_table.php：

<?php
// 初始化PDO连接（可以复用你应用里的数据库连接）
$pdo = new PDO('mysql:host=localhost;dbname=your_database', 'username', 'password');

// 检查comments表是否存在，不存在则创建
if (!tableExists($pdo, 'comments')) {
    $createSql = "CREATE TABLE `comments` ( 
        `comment_id` int(11) NOT NULL AUTO_INCREMENT, 
        `content_id` int(11) DEFAULT '0', 
        `body` text, 
        `name` text, 
        `creation_ts` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP, 
        `delta` int(1) NOT NULL DEFAULT '0', 
        PRIMARY KEY (`comment_id`) 
    ) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;";
    $pdo->exec($createSql);
    error_log("Created comments table successfully");
} else {
    // 如果后续需要给comments表加新列，比如email
    if (!columnExists($pdo, 'comments', 'email')) {
        $alterSql = "ALTER TABLE `comments` ADD COLUMN `email` varchar(255) DEFAULT NULL AFTER `name`;";
        $pdo->exec($alterSql);
        error_log("Added email column to comments table");
    }
}

3. 半自动化执行迁移 #

为了不用每次手动跑脚本，我们可以做一个自动执行的机制：

步骤1：创建迁移日志表

用来记录已经执行过的迁移脚本，避免重复执行：

CREATE TABLE `migrations_log` (
    `id` int(11) AUTO_INCREMENT PRIMARY KEY,
    `script_name` varchar(255) NOT NULL,
    `executed_at` timestamp DEFAULT CURRENT_TIMESTAMP,
    UNIQUE KEY `script_name_unique` (`script_name`)
);

步骤2：编写迁移执行入口

写一个run_migrations.php脚本，遍历所有迁移文件，对比日志表执行未运行的脚本：

<?php
$pdo = new PDO('mysql:host=localhost;dbname=your_database', 'username', 'password');

// 确保迁移日志表存在
if (!tableExists($pdo, 'migrations_log')) {
    $pdo->exec("CREATE TABLE `migrations_log` (
        `id` int(11) AUTO_INCREMENT PRIMARY KEY,
        `script_name` varchar(255) NOT NULL,
        `executed_at` timestamp DEFAULT CURRENT_TIMESTAMP,
        UNIQUE KEY `script_name_unique` (`script_name`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;");
}

// 获取已执行的脚本列表
$executedScripts = [];
$stmt = $pdo->query("SELECT script_name FROM migrations_log");
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    $executedScripts[] = $row['script_name'];
}

// 遍历migrations目录下的脚本
$migrationsDir = __DIR__ . '/migrations/';
$files = scandir($migrationsDir);
foreach ($files as $file) {
    if ($file === '.' || $file === '..') continue;
    if (!in_array($file, $executedScripts)) {
        // 执行迁移脚本
        require_once $migrationsDir . $file;
        // 记录到日志表
        $stmt = $pdo->prepare("INSERT INTO migrations_log (script_name) VALUES (?)");
        $stmt->execute([$file]);
        error_log("Executed migration: " . $file);
    }
}

步骤3：触发迁移

• 可以在应用后台管理页加一个「执行数据库迁移」的按钮，点击后调用这个脚本；
• 或者在应用启动时（比如index.php开头）自动执行这个脚本（建议只给管理员权限，或者生产环境加开关）。

关键注意事项 #

• 脚本幂等性：所有迁移脚本必须先检查对象是否存在再执行操作，避免重复创建导致报错；
• 测试先行：生产环境执行前，一定要在测试环境跑一遍迁移脚本，确保语法和逻辑没问题；
• 自动备份：执行迁移前可以自动备份数据库（比如用PHP执行mysqldump命令），防止出问题能快速回滚；
• 版本控制：把所有迁移脚本和代码一起放到Git等版本控制系统，确保每次代码更新对应正确的数据库变更。

内容的提问来源于stack exchange，提问作者Bashman