PHP 使用 ODBC 連接資料庫完整範例

PHP 使用 ODBC 連接資料庫完整範例

ODBC (Open Database Connectivity) 提供統一介面存取不同資料庫 (MySQL、PostgreSQL、SQL Server、Access 等)。本文示範 PHP odbc_* 函數族連接 MySQL 的完整流程：DSN 設定、連線、查詢、結果遍歷、關閉連線、錯誤處理，並說明免 DSN 連接字串寫法。

完整程式碼 (odbc_demo.php)

<!DOCTYPE html>
<html lang="zh-TW">
<head>
    <meta charset="UTF-8">
    <title>PHP ODBC 連線測試</title>
</head>
<body>
<?php
// 1. 連接字串 (免 DSN，直接指定驅動程式)
$connStr = "DRIVER={MySQL ODBC 8.0 Unicode Driver};Server=127.0.0.1;Port=3306;Database=testdb;Charset=utf8mb4;";

$username = 'dbuser';
$password = 'dbpass';

echo '<h3>嘗試連接...</h3>';

// 2. 建立連線
$conn = odbc_connect($connStr, $username, $password);

if (!$conn) {
    echo '<p style="color:red;">連線失敗: </p>';
    echo '<pre>' . htmlspecialchars(odbc_errormsg()) . '</pre>';
    exit;
}

echo '<p style="color:green;">連線成功!</p>';

// 3. 執行查詢
$sql = "SELECT 1 AS test_value, 'Hello ODBC' AS message";
$result = odbc_exec($conn, $sql);

if (!$result) {
    echo '<p style="color:red;">查詢失敗: </p>';
    echo '<pre>' . htmlspecialchars(odbc_errormsg($conn)) . '</pre>';
    odbc_close($conn);
    exit;
}

// 4. 輸出結果表格
echo '<table border="1" cellpadding="6" cellspacing="0">';
echo '<tr><th>test_value</th><th>message</th></tr>';

while (odbc_fetch_row($result)) {
    $val1 = odbc_result($result, 'test_value');
    $val2 = odbc_result($result, 'message');
    echo "<tr><td>{$val1}</td><td>{$val2}</td></tr>";
}

echo '</table>';

// 5. 釋放資源並關閉
odbc_free_result($result);
odbc_close($conn);

echo '<p>連線已關閉。</p>';
?>
</body>
</html>

關鍵函數對照表

常見驅動程式連接字串範例

# MySQL (需安裝 MySQL ODBC Driver)
DRIVER={MySQL ODBC 8.0 Unicode Driver};Server=host;Port=3306;Database=db;Charset=utf8mb4;UID=user;PWD=pass;

# PostgreSQL
DRIVER={PostgreSQL Unicode};Server=host;Port=5432;Database=db;UID=user;PWD=pass;

# SQL Server (Microsoft ODBC Driver 17/18)
DRIVER={ODBC Driver 18 for SQL Server};Server=tcp:host,1433;Database=db;UID=user;PWD=pass;Encrypt=yes;TrustServerCertificate=no;

# Microsoft Access (.accdb)
DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:\path\file.accdb;

# Oracle
DRIVER={Oracle in OraClient12Home1};DBQ=host:1521/sid;UID=user;PWD=pass;

部署環境安裝步驟 (Linux 以 MySQL 為例)

1. 安裝 unixODBC：yum install unixODBC unixODBC-devel 或 apt install unixodbc unixodbc-dev。
2. 安裝 MySQL ODBC Driver：下載 .tar.gz 解壓，執行 ./install.sh 或手動複製 libmyodbc8w.so 至 /usr/lib64/，註冊 odbcinst.ini。
3. 驗證驅動：odbcinst -q -d -n "MySQL ODBC 8.0 Unicode Driver"。
4. PHP 安裝 odbc 擴充套件：docker-php-ext-install odbc 或 yum install php-odbc / apt install php-odbc。
5. 重啟 PHP-FPM/Apache，php -m | grep odbc 確認載入。

ODBC vs 原生驅動 (PDO_MySQL / mysqli) 選擇建議

ODBC 是跨資料庫整合的標準橋樑，掌握其連線字串組裝與錯誤處理，能在異構系統整合專案中發揮關鍵作用。