萬盛學電腦網

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

解決 PHP Fatal error: Call to undefined function mssql_connect() 完整排查指南

錯誤含義

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_sqlsrv5.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_*` (別名)舊專案遷移過渡用,功能受限⭐⭐

Windows + PHP 8.x 安裝 sqlsrv/pdo_sqlsrv 步驟

1. 下載對應版本 DLL

2. 放置 DLL

; 解壓縮後複製到 PHP ext 目錄
C:\php\ext\php_sqlsrv_82_ts_x64.dll
C:\php\ext\php_pdo_sqlsrv_82_ts_x64.dll

3. 安裝 Microsoft ODBC Driver for SQL Server

4. 修改 php.ini 啟用擴充

extension_dir = "C:/php/ext"
extension=php_sqlsrv_82_ts_x64
extension=php_pdo_sqlsrv_82_ts_x64

注意:`extension=` 後**不加 .dll**,PHP 會自動補全。

5. 重啟 Web 伺服器 / PHP-FPM

; Apache
httpd -k restart

; Nginx + PHP-FPM
net stop php-fpm && net start php-fpm
; 或 systemctl restart php8.2-fpm (Linux)

6. 驗證安裝

<?php
phpinfo(); // 搜尋 "sqlsrv"、"pdo_sqlsrv" 區塊

// 或 CLI
php -m | findstr sqlsrv

連線程式碼範例 (sqlsrv / PDO)

<?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

遷移舊代碼:mssql_* → sqlsrv_* / PDO 對照表

舊函式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 功能、長期維護的資料庫存取層。

copyright © 萬盛學電腦網 all rights reserved