萬盛學電腦網

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

PHP 數組轉 JSON 的手動實現與最佳實踐

前言

雖然 PHP 5.2+ 內建 json_encode,但理解其底層邏輯有助於處理特殊需求(如舊版本兼容、自定義編碼規則)。本文提供一個純 PHP 實現的 array_to_json 函數,支持關聯數組與索引數組的區分、遞歸嵌套、字符串轉義。

完整實現代碼

<?php
function array_to_json($array) {
    if (!is_array($array)) {
        return false;
    }

    // 判斷是否為關聯數組
    $associative = count(array_diff(array_keys($array), array_keys(array_keys($array))));

    if ($associative) {
        $construct = array();
        foreach ($array as $key => $value) {
            // 鍵名處理:數字鍵加前綴,字符串鍵加引號並轉義
            if (is_numeric($key)) {
                $key = "key_$key";
            }
            $key = "'" . addslashes($key) . "'";

            // 值處理:遞歸或轉義
            if (is_array($value)) {
                $value = array_to_json($value);
            } elseif (!is_numeric($value) || is_string($value)) {
                $value = "'" . addslashes($value) . "'";
            }

            $construct[] = "$key: $value";
        }
        $result = "{ " . implode(", ", $construct) . " }";
    } else {
        $construct = array();
        foreach ($array as $value) {
            if (is_array($value)) {
                $value = array_to_json($value);
            } elseif (!is_numeric($value) || is_string($value)) {
                $value = "'" . addslashes($value) . "'";
            }
            $construct[] = $value;
        }
        $result = "[ " . implode(", ", $construct) . " ]";
    }

    return $result;
}
?>

關鍵邏輯解析

  • 關聯數組判斷:通過比較鍵名與連續整數索引的差異確定數組類型。
  • 鍵名標準化:數字鍵加 key_ 前綴,確保 JSON 合法性;所有鍵名雙引號包裹並轉義。
  • 值類型處理:數組遞歸,字符串/非純數字加引號轉義,純數字直接輸出。
  • 結構組裝:關聯數組生成 {key: value},索引數組生成 [value]。

使用示例

<?php
$data = array(
    'name' => '張三',
    'age' => 25,
    'tags' => array('php', 'json'),
    'active' => true
);
echo array_to_json($data);
// 輸出:{'name': '張三', 'age': 25, 'tags': ['php', 'json'], 'active': true}

注意事項

  • 此實現為教學演示,生產環境強烈建議使用內建 json_encode(性能更高、支持更多類型、符合 RFC 8259 標準)。
  • 布爾值 true/false 會被作為字符串處理,標準 JSON 應為無引號字面量。
  • NULL 值未特別處理,會輸出空字符串。

總結

手動實現 JSON 編碼能深入理解數據結構序列化原理,但在實際項目中請優先使用內建函數,必要時通過 JSON_* 常量調整行為。

copyright © 萬盛學電腦網 all rights reserved