Fatal error: Call to undefined function mssql_connect() in ...
表示 PHP 環境**未載入 MSSQL 擴充套件**,或載入的版本與 PHP/資料庫不相容。`mssql_*` 函式屬於舊版 **Sybase/CT-Library** 驅動,**PHP 5.3 後棄用,PHP 7.0 完全移除**。
| 驅動 | PHP 版本 | 函式/類別 | 狀態 | 推薦度 |
|---|---|---|---|---|
| sqlsrv (Microsoft 官方) | 5.3 - 8.3+ | `sqlsrv_connect()`, `PDO::SQLSRV` | **官方維護、功能完整、支援新特性** | ⭐⭐⭐⭐⭐ |
| pdo_sqlsrv | 5.3 - 8.3+ | `new PDO("sqlsrv:...")` | PDO 介面、參數化查詢、交易支援 | ⭐⭐⭐⭐⭐ |
| ODBC (unixODBC + MS ODBC Driver) | 所有版本 | `odbc_connect()`, `PDO::ODBC` | 跨平台、通用但配置複雜 | ⭐⭐⭐ |
| mssql (舊 Sybase/CT-Lib) | < 7.0 | `mssql_connect()` | **已移除,不可用** | ❌ |
| dblib (FreeTDS) | 5.x - 8.x | `pdo_dblib`, `mssql_*` (別名) | 舊專案遷移過渡用,功能受限 | ⭐⭐ |
; 解壓縮後複製到 PHP ext 目錄
C:\php\ext\php_sqlsrv_82_ts_x64.dll
C:\php\ext\php_pdo_sqlsrv_82_ts_x64.dll
extension_dir = "C:/php/ext"
extension=php_sqlsrv_82_ts_x64
extension=php_pdo_sqlsrv_82_ts_x64
注意:`extension=` 後**不加 .dll**,PHP 會自動補全。
; Apache
httpd -k restart
; Nginx + PHP-FPM
net stop php-fpm && net start php-fpm
; 或 systemctl restart php8.2-fpm (Linux)
<?php
phpinfo(); // 搜尋 "sqlsrv"、"pdo_sqlsrv" 區塊
// 或 CLI
php -m | findstr sqlsrv
<?php
// sqlsrv 程序式
$server = 'localhost';
$db = 'MyDatabase';
$uid = 'sa';
$pwd = 'StrongPass123';
$connInfo = [
'Database' => $db,
'UID' => $uid,
'PWD' => $pwd,
'CharacterSet' => 'UTF-8',
'Encrypt' => true, // Azure SQL / 強制加密需 true
'TrustServerCertificate' => false, // 生產環境 false,需有效憑證
];
$conn = sqlsrv_connect($server, $connInfo);
if ($conn === false) {
die(print_r(sqlsrv_errors(), true));
}
echo "sqlsrv 連線成功\n";
// PDO::SQLSRV (推薦)
$dsn = "sqlsrv:Server=$server;Database=$db;Encrypt=true;TrustServerCertificate=false";
try {
$pdo = new PDO($dsn, $uid, $pwd, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
echo "PDO 連線成功\n";
} catch (PDOException $e) {
die("PDO 失敗: " . $e->getMessage());
}
| 錯誤現象 | 原因 | 解決 |
|---|---|---|
| PHP 啟動警告:Unable to load dynamic library 'php_sqlsrv' | DLL 檔名錯誤、TS/NTS 不匹配、x86/x64 不匹配、缺少 VC++ Runtime | 核對 `php -i | findstr "Thread Safety"`、`php -i | findstr "Compiler"`,下載完全匹配版本;安裝 Visual C++ Redistributable |
| sqlsrv_connect 失敗:[Microsoft][ODBC Driver 18] SSL Provider: certificate chain | 伺服器憑證不受信任 (自簽憑證) | 開發環境暫時 `'TrustServerCertificate' => true`;生產環境部署有效憑證或匯入 CA |
| 找不到 msodbcsql18.dll | 未安裝 ODBC Driver 或版本不符 | 安裝對應版本 ODBC Driver (17/18),確認 `odbcad32.exe` 驅動程式頁面可見 |
| Linux (Docker) 環境連線失敗 | 缺少 unixODBC、MS ODBC Driver、locale 設定 | 使用官方 Dockerfile 範例:`FROM mcr.microsoft.com/mssql/server:2022-latest` 或 PHP 映像安裝 msphpsql |
| 舊函式 | sqlsrv 替代 | PDO 替代 |
|---|---|---|
| `mssql_connect()` | `sqlsrv_connect()` | `new PDO($dsn, $user, $pass)` |
| `mssql_query()` | `sqlsrv_query()` | `$pdo->query()` / `$pdo->prepare()` |
| `mssql_fetch_array()` | `sqlsrv_fetch_array()` | `$stmt->fetch(PDO::FETCH_ASSOC)` |
| `mssql_num_rows()` | `sqlsrv_num_rows()` (需捲動游標) | `$stmt->rowCount()` (不精確) / `COUNT(*)` 查詢 |
| `mssql_free_result()` | `sqlsrv_free_stmt()` | `$stmt = null` |
| `mssql_close()` | `sqlsrv_close()` | `$pdo = null` |
`mssql_connect` 是歷史產物,**請立即遷移至 Microsoft 官方 sqlsrv/pdo_sqlsrv 驅動**。遵循本文安裝步驟、驗證連線、逐步替換舊代碼,即可獲得安全、支援最新 SQL Server 功能、長期維護的資料庫存取層。