萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 解析並執行 SQL 腳本文件:安裝程式/備份還原核心邏輯

核心挑戰

SQL 文件包含多條語句,以分號 ; 分隔,但分號可能出現在字串、註解、觸發器定義中。簡單 explode(';', $sql) 會誤切。需逐行讀取、識別語句邊界。

健壯解析實現

<?php
/**
 * 執行 SQL 文件
 * @param PDO $pdo 已連線的 PDO 實例
 * @param string $filePath SQL 文件路徑
 * @return array [successCount, errors]
 */
function executeSqlFile(PDO $pdo, string $filePath): array {
    if (!is_readable($filePath)) {
        throw new InvalidArgumentException("SQL 文件不可讀: $filePath");
    }

    $sql = '';
    $success = 0;
    $errors = [];
    $lineNum = 0;

    $handle = fopen($filePath, 'r');
    while (($line = fgets($handle)) !== false) {
        $lineNum++;
        $trimmed = trim($line);

        // 跳過空行與註解行
        if ($trimmed === '' || str_starts_with($trimmed, '--') || str_starts_with($trimmed, '#')) {
            continue;
        }

        $sql .= $line;

        // 簡易判斷:行尾為分號且非在字串中(這裡簡化,完整需狀態機)
        // 實際專案建議使用成熟庫如 `paragonie/sql-parser` 或直接用 mysql client
        if (substr(rtrim($line), -1) === ';') {
            try {
                $pdo->exec($sql);
                $success++;
            } catch (PDOException $e) {
                $errors[] = "Line ~$lineNum: " . $e->getMessage() . " | SQL: $sql";
            }
            $sql = '';
        }
    }
    fclose($handle);

    // 處理文件末尾無分號的最後一條語句
    if (trim($sql) !== '') {
        try {
            $pdo->exec($sql);
            $success++;
        } catch (PDOException $e) {
            $errors[] = "Line ~$lineNum (EOF): " . $e->getMessage() . " | SQL: $sql";
        }
    }

    return [$success, $errors];
}

// 使用示例
try {
    $pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'root', '');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    [$ok, $errs] = executeSqlFile($pdo, __DIR__ . '/install.sql');
    echo "成功執行 $ok 條語句\n";
    if ($errs) {
        echo "錯誤:\n" . implode("\n", $errs);
    }
} catch (Exception $e) {
    echo "致命錯誤: " . $e->getMessage();
}
?>

生產環境建議

  • 使用 mysql -u user -p db < install.sql 命令列工具,效能最高、解析最準確。
  • PHP 端若需純 PHP 解析,考慮 symfony/console + doctrine/dbal 的 Connection::executeStatement() 批次執行。
  • 大文件分批執行,避免記憶體耗盡或超時。
  • 事務包裹:若需原子性,外層開啟事務,但 DDL (CREATE TABLE) 在 MySQL 中會隱性提交,無法回滾。
copyright © 萬盛學電腦網 all rights reserved