萬盛學電腦網

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

PHP 安裝 dblib/pdo_dblib 擴展連接 Microsoft SQL Server 完整編譯步驟 (CentOS/FreeTDS)

在 Linux (CentOS/RHEL) 上讓 PHP 連接 Microsoft SQL Server,需依序編譯安裝 FreeTDS → mssql (舊擴充) → pdo_dblib (PDO 驅動)。本文記錄無坑編譯參數、配置修正與連線驗證全流程。

版本關鍵提示

  • FreeTDS 版本:勿使用 0.82+** (編譯失敗),建議 **0.91.x** 或 **1.00.x** 穩定版。
  • PHP 版本需與 phpize、php-config 路徑一致 (如 /usr/local/php/bin/)。

1. 編譯安裝 FreeTDS

cd freetds-1.00.x
./configure --prefix=/usr/local/freetds \
            --enable-msdblib \
            --enable-sybase-compat \
            --disable-threadsafe \
            --with-openssl=/usr/include/openssl  # 可選,支援 TLS
make && make install

2. 編譯安裝 mssql 擴充 (PHP 7.0+ 已移除,僅 PHP 5.6/7.0 早期版本需要)

cd php-7.0.x/ext/mssql
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config --with-mssql=/usr/local/freetds
make && make install
PHP 7.1+ **已移除 mssql 擴充**,請直接使用 pdo_dblib (PDO) 或 sqlsrv (Microsoft 官方驅動,僅限 Windows/Linux 官方包)。

3. 編譯安裝 pdo_dblib (PDO 驅動,推薦)

cd php-7.x.x/ext/pdo_dblib
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config --with-pdo-dblib=/usr/local/freetds
make && make install

4. 修改 php.ini 載入擴充

extension=pdo_dblib.so
; extension=mssql.so  (僅 PHP 5.6/7.0 需要)
重啟 php-fpm / Apache:systemctl restart php-fpm 或 apachectl graceful。

5. FreeTDS 客戶端配置與連線測試

修改 /usr/local/freetds/etc/freetds.conf

[global]
    tds version = 8.0      # SQL Server 2008+ 使用 8.0 (TDS 7.4)
    client charset = UTF-8 # 關鍵:解決中文亂碼
    text size = 64512      # 避免長文本截斷

# 具名實例範例 (可選)
[mssql]
    host = 192.168.1.100
    port = 1433
    tds version = 8.0

命令列測試連線

/usr/local/freetds/bin/tsql -H 192.168.1.100 -p 1433 -U sa -P 'password' -D dbname

成功會進入 `1>` 提示符,輸入 `SELECT @@VERSION; GO` 驗證。

6. PHP PDO 連線字串 (DSN)

$dsn = 'dblib:host=192.168.1.100:1433;dbname=your_db;charset=utf8';
$pdo = new PDO($dsn, 'sa', 'password', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_EMULATE_PREPARES => false, // 使用真實預備語句
]);
關鍵:DSN 中 **必須包含埠號** (`host=ip:port`),否則 FreeTDS 預設尋找 1433 但某些環境會失敗。

常見錯誤與解決

生產環境建議

  • 優先使用 Microsoft 官方 **sqlsrv/pdo_sqlsrv** 驅動 (Linux 版已開源),效能、功能支援 (Always Encrypted、資料表值參數) 完勝 dblib。
  • 若必須用 dblib,請鎖定 FreeTDS 1.00.x、PHP 7.4/8.1 LTS 版本,並建立 Dockerfile 固化建置流程。

遵循上述編譯參數與配置步驟,可在 Linux 上穩定實現 PHP 連接 SQL Server。

copyright © 萬盛學電腦網 all rights reserved
錯誤現象原因解決
Adaptive Server is unavailable or does not exist埠號未指定/防火牆阻擋/實例名錯誤DSN 加 :1433、開放防火牆、確認 SQL Browser 服務
中文亂碼/問號freetds.conf 缺 client charset加入 client charset = UTF-8
編譯失敗: ld: cannot find -lsybdbFreeTDS 庫路徑未加入 ldconfigecho "/usr/local/freetds/lib" > /etc/ld.so.conf.d/freetds.conf && ldconfig
PDO 驅動未找到php.ini 未載入 pdo_dblib.sophp -m | grep pdo_dblib 確認,檢查 extension_dir