mysqli_result::$lengths 與mysqli_fetch_assoc() 配合使用的技巧

gitbox 2025-05-29

在使用PHP 操作MySQL 數據庫時， mysqli_fetch_assoc()是最常見的結果集提取方法之一，它將結果集的一行以關聯數組的形式返回。而mysqli_result::$lengths是mysqli_result類的一個屬性，它在你從結果集中提取了一行之後，返回當前行各字段內容的字節長度數組。

這兩者結合使用，雖然並不常被提及，但在處理某些邊緣場景時非常實用，尤其是在數據完整性校驗、二進制數據處理、以及動態UI 渲染中。本文將深入探討這兩個功能結合使用時的一些實用技巧。

1. 獲取字段實際長度vs 預期長度

mysqli_fetch_assoc()獲取的是字段的“值”，而不是其原始字節大小。而mysqli_result::$lengths返回的是原始數據在傳輸中的字節長度，特別在處理UTF-8 字符或BLOB 類型時，這一點非常重要。

 $conn = new mysqli("localhost", "user", "password", "database");
$result = $conn->query("SELECT name, bio FROM users");

while ($row = $result->fetch_assoc()) {
    $lengths = $result->lengths;
    echo "Name: " . $row['name'] . " (Length: " . $lengths[0] . " bytes)\n";
    echo "Bio: " . $row['bio'] . " (Length: " . $lengths[1] . " bytes)\n";
}

此技巧適用於內容長度需要精確掌控的場景，比如發送摘要、日誌數據校驗、或通過HTTP Header 限制內容大小。

2. 檢測內容截斷或編碼異常

有時從前端傳入的數據可能由於編碼問題或存儲約束而被數據庫截斷。使用$result->lengths可以檢測實際內容長度是否達到預期，結合字段最大長度限制進行校驗。

例如，如果bio字段最大長度是65535 字節，而$lengths[1]恰好等於65535，就可以警惕這段文本可能已經被截斷。

3. 分析富文本或含多語言的字段數據

富文本內容、或包含中日韓字符的數據，其字符數與字節數差距可能很大。結合strlen($row['field'])與$result->lengths可以評估字符編碼分佈。

 $charLength = strlen($row['bio']);
$byteLength = $lengths[1];
if ($byteLength / $charLength > 2) {
    echo "該字段可能含多字節字符，建議轉碼或壓縮。";
}

4. 為下載或API 返回內容生成準確Header

在構建REST API 時，特別是返回大文本或二進製文件（如PDF、圖片）時，精確的Content-Length是必需的。結合$result->lengths可以動態設定Header。

 header("Content-Type: text/plain");
header("Content-Length: " . $lengths[0]);
echo $row['document_text'];

這在構建類似https://gitbox.net/api/v1/documents/123/download的文件下載接口時尤為關鍵。

5. 調試數據庫返回數據異常

當你從數據庫中查詢返回的數據亂碼或丟失字符時，第一步可以對比strlen($row['field'])與$result->lengths[index] ，看看是否有編碼對不上或字符被誤截斷的現象。

這種方式比盲目打印字符串更高效，尤其是在二進制內容處理上更為安全。

小結

mysqli_result::$lengths並非日常開發中頻繁使用的工具，但當你需要對MySQL 返回數據的原始字節進行更深控制時，它與mysqli_fetch_assoc()的配合使用可以發揮重要作用。尤其在編碼敏感、內容截斷敏感、或傳輸帶寬優化等場景下，結合使用可帶來更強的掌控力。

通過這些技巧，不僅可以提升PHP 與MySQL 數據交互的健壯性，也能為後續功能擴展和性能優化打下良好基礎。