萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

PHP 陣列傳遞給 JavaScript:json_encode 完整教學

PHP 後端陣列需傳給前端 JavaScript 使用,標準做法是 json_encode() 序列化為 JSON 字串,前端直接解析或內嵌為 JS 變數。

PHP 端編碼

<?php
$arr = array(
    'id' => 1,
    'name' => '產品A',
    'tags' => array('熱銷', '新品'),
    'specs' => array(
        array('color' => '紅', 'size' => 'M'),
        array('color' => '藍', 'size' => 'L')
    )
);

$json = json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// 輸出:{"id":1,"name":"產品A","tags":["熱銷","新品"],"specs":[{"color":"紅","size":"M"},{"color":"藍","size":"L"}]}

echo "var productData = " . $json . ";";
?>

常用旗標:

  • JSON_UNESCAPED_UNICODE:中文不轉 \uXXXX,可讀性佳。
  • JSON_UNESCAPED_SLASHES:不轉義斜線。
  • JSON_NUMERIC_CHECK:數字字串轉數值型別(慎用,可能改變精度)。

前端接收方式

方式一:內嵌在頁面腳本中(傳統)

<script>
<?php echo "var productData = " . $json . ";"; ?>
// 直接使用 productData 變數
console.log(productData.name); // "產品A"
</script>

方式二:AJAX 非同步請求(現代 SPA 推薦)

<!-- PHP API 端點 api/product.php -->
<?php
header('Content-Type: application/json; charset=utf-8');
echo json_encode($arr, JSON_UNESCAPED_UNICODE);
?>

// 前端 fetch
fetch('api/product.php')
    .then(r => r.json())
    .then(data => console.log(data.tags)); // ["熱銷", "新品"]

方式三:data-* 屬性傳遞簡單資料

<div id="product" data-info='<?= json_encode($arr, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>'></div>

<script>
var data = JSON.parse(document.getElementById('product').dataset.info);
</script>

使用 JSON_HEX_* 旗標確保安全嵌入 HTML 屬性。

注意事項

  • PHP 5.2+ 內建 JSON 擴充,舊版需安裝 pecl/json。
  • 資源型別、物件含循環引用無法直接編碼,需先轉陣列。
  • 大數據量時注意記憶體上限(memory_limit)與輸出緩衝。
copyright © 萬盛學電腦網 all rights reserved