PHP 讀取 MSSQL ntext 字段數據截斷與讀取失敗的綜合解決方案

問題現象

• ntext 字段內容較長時，PHP 只讀取前 4KB 數據。
• ODBC 連接下 ntext 字段返回空/NULL。
• 轉換 CONVERT(text, ntext_col) 仍截斷或報錯。

根因分析

1. PHP mssql 擴展默認限制：mssql.textlimit 和 mssql.textsize 默認 4096 字節。
2. ntext/nvarchar 是 Unicode (UCS-2)，舊 mssql 擴展處理不當導致讀取異常。
3. ODBC 驅動兼容性：舊版 SQL Server ODBC 驅動不支持 ntext 完整讀取。

方案一：調整 php.ini 限制（針對 mssql 擴展）

; php.ini
; 最大文本長度 (字節)，範圍 0-2147483647
mssql.textlimit = 2147483647
mssql.textsize = 2147483647

修改後**必須重啟 Web 服務器**生效。

方案二：SQL 查詢層面轉換（臨時緩解）

<?php
// 錯誤寫法
$sql = "SELECT ntext_col FROM table"; // 可能截斷/報錯

// 正確寫法：顯式轉為 text (非 unicode)
$sql = "SELECT CONVERT(text, ntext_col) AS content FROM table";
// 或 varchar(max) (SQL Server 2005+)
$sql = "SELECT CAST(ntext_col AS varchar(max)) AS content FROM table";
?>

缺點：超長文本仍可能截斷；轉換過程可能導致編碼問題。

方案三：更換連接方式（關鍵突破）

<?php
// 原來使用 odbc_connect (失敗)
// 改用 mssql_connect (成功讀取完整 ntext)
$conn = mssql_connect('SERVER\INSTANCE', 'user', 'pass');
mssql_select_db('db', $conn);
$res = mssql_query("SELECT ntext_col FROM table", $conn);
$row = mssql_fetch_assoc($res);
// 現在可獲取完整內容
?>

方案四：虛擬主機/無權限環境 → ADODB 庫

<?php
require_once 'adodb/adodb.inc.php';
$conn = NewADOConnection('odbc_mssql');
$conn->Connect("Driver={SQL Server};Server=localhost;Database=mydb;", 'user', 'pass');
$rs = $conn->Execute("SELECT ntext_col FROM table");
while (!$rs->EOF) {
    echo $rs->fields['ntext_col'];
    $rs->MoveNext();
}
?>

前提：服務器安裝了 SQL Server 2000+ 客戶端組件 (ntwdblib.dll 2000.80.xxx)。

現代化終極建議：遷移至官方驅動

• Microsoft Drivers for PHP for SQL Server (sqlsrv/pdo_sqlsrv)：原生支持 ntext/nvarchar(max)/varchar(max)、UTF-8、Linux/macOS、PHP 7/8。
• 安裝：pecl install sqlsrv pdo_sqlsrv
• 代碼：
  $conn = sqlsrv_connect($server, ['Database'=>'db', 'UID'=>'user', 'PWD'=>'pass']);
$stmt = sqlsrv_query($conn, "SELECT ntext_col FROM table");
while ($row = sqlsrv_fetch_array($stmt)) { echo $row['ntext_col']; }

遷移清單

1. 評估現有 ntext 字段長度分布（SELECT MAX(LEN(ntext_col)) FROM table）。
2. 測試環境驗證 sqlsrv 驅動完整讀取。
3. 修改應用代碼替換 mssql_*/odbc_* 函數。
4. 生產環境灰度發布，監控錯誤率與性能。