PHP ODBC 函式完整分類參考：連線、操作、資訊獲取三大類

前言

ODBC (Open Database Connectivity) 提供統一介面存取不同資料庫（MSSQL、Access、MySQL、PostgreSQL 等）。PHP ODBC 擴展需安裝 php-odbc 並啟用 extension=odbc。現代專案建議改用 PDO_ODBC 或原生 PDO 驅動。

一、連線管理函式

DSN 設定方式

• 系統 DSN： 控制台 → 系統管理工具 → ODBC 資料來源 → 系統 DSN
• 無 DSN 連線字串：
  odbc_connect("Driver={SQL Server};Server=192.168.1.10;Database=test;", 'user', 'pass')

二、SQL 執行與結果處理

結果集讀取

三、中繼資料與目錄函式

四、欄位屬性函式

五、錯誤處理

六、其他設定

完整範例：查詢 MSSQL

<?php
// 連線
$conn = odbc_connect("Driver={ODBC Driver 17 for SQL Server};Server=192.168.1.10;Database=test;", 'sa', 'password');
if (!$conn) {
    die("連線失敗: " . odbc_errormsg());
}

// 執行查詢
$sql = "SELECT id, name, email FROM users WHERE status = ?";
$stmt = odbc_prepare($conn, $sql);
if (!$stmt) die("預備失敗: " . odbc_errormsg($conn));

$params = ['active'];
if (!odbc_execute($stmt, $params)) {
    die("執行失敗: " . odbc_errormsg($conn));
}

// 讀取結果
$results = [];
while (odbc_fetch_row($stmt)) {
    $results[] = [
        'id'    => odbc_result($stmt, 'id'),
        'name'  => odbc_result($stmt, 'name'),
        'email' => odbc_result($stmt, 'email'),
    ];
}

odbc_free_result($stmt);
odbc_close($conn);

print_r($results);
?>

現代替代方案建議

常見問題

1. 中文亂碼： 確保連線字串含 CharacterSet=UTF-8，資料庫欄位為 NVARCHAR，PHP 腳本為 UTF-8。
2. odbc_num_rows() 回傳 -1：部分驅動不支援，改用 SELECT COUNT(*) 或迴圈計數。
3. 長文字截斷： 執行前呼叫 odbc_longreadlen($result, 1000000)。
4. 64 位元系統： 需安裝 64 位元 ODBC 驅動程式，並用 64 位元 PHP。