php json 格式控制

本文同步至我的個人博客：http://www.52cik.com/2015/12/23/php-json-format.html

關於 json 這個問題，陸陸續續有新手朋友找我問，比如為什么我輸出的是 {"1":"item1","2":"item2","3":"item3"} 而不是 ["item1","item2","item3"]。

php數組 與 js數組

我這里用 php 5.4 以上語法表示。

php 里有關聯數組和索引數組，例如：

<?php
// 索引數組
$arr = ['item1', 'item2', 'item3'];

// 關聯數組
$arr = [
  'name' => '張三',
  'age' => '22',
];

而 js 里只有一種數組，那就是索引數組，也許你會說可以用 K/V 鍵值對形式模擬關聯數組啊。
K/V 鍵值對看起來像，但他沒有任何數組特性，這里就不詳細說明了。

而上面的 php 數組 json_encode 后得到的 json 格式分別是 ["item1","item2","item3"] 和 {"name":"\u5f20\u4e09","age":"22"}。這里的中文被轉為 Unicode 了，如果你非要顯示中文，php 5.4 之后支持 JSON_UNESCAPED_UNICODE 參數，json_encode($arr, JSON_UNESCAPED_UNICODE) 即可得到 {"name":"張三","age":"22"}，不過非常不推薦這樣寫。

這里分別得到的是 js 下的 數組 和 對象 格式的 json 字符串，那為什么會生成這兩種類型，或者說，什么情況會生成對象格式，什么情況會生成數組格式呢。

php 數組 輸出格式控制

大致幾種情況我都列出來了，直接看代碼。

<?php

$arr = [ // 不是 0 開始，會輸出對象
  1 => 'item1',
  2 => 'item2',
  3 => 'item3',
];
echo "輸出對象: ", json_encode($arr), "\n";
// 輸出對象: {"1":"item1","2":"item2","3":"item3"}

$arr = [ // 連續索引，輸出數組
  0 => 'item1',
  1 => 'item2',
  2 => 'item3',
];
echo "輸出數組: ", json_encode($arr), "\n";
// 輸出數組: ["item1","item2","item3"]

$arr = [ // 連續索引，輸出數組 
  'item1',
  'item2',
  'item3',
];
echo "輸出數組: ", json_encode($arr), "\n";
// 輸出數組: ["item1","item2","item3"]

$arr = [ // 索引不連續，輸出對象
  0 => 'item1',
  1 => 'item2',
  2 => 'item3',
  5 => 'item5',
];
echo "輸出對象: ", json_encode($arr), "\n";
// 輸出對象: {"0":"item1","1":"item2","2":"item3","5":"item5"}

$arr = [ // 包含關聯索引，一定輸出對象
  0 => 'item1',
  1 => 'item2',
  2 => 'item3',
  'other' => '其他字段'
];
echo "輸出對象: ", json_encode($arr), "\n";
// 輸出對象: {"0":"item1","1":"item2","2":"item3","other":"\u5176\u4ed6\u5b57\u6bb5"}

// 關聯數組 + 索引數組 實例
$arr = [ // 關聯數組
  'other' => '其他字段',
  'count' => 3, // 數組個數
  'list' => [ // 索引數組
    'item1',
    'item2',
    'item3',
  ],
];
echo "對象+數組: ", json_encode($arr), "\n";
// 對象+數組: {"other":"\u5176\u4ed6\u5b57\u6bb5","count":3,"list":["item1","item2","item3"]}

其實第一種就是很多新手朋友經常遇到的問題。
因為數據庫讀出來后他們喜歡把 id 當索引用，而數據庫的 id 不是從 0 開始的，看下這個例子。

$arr = $User->where($where)->find(); // 讀取數據

$list = [];
foreach($arr as $key => $val) { // 遍歷數組
  $list[$key] = [
    'name' => $val['name'],
    'age' => $val['age'],
  ];
}

$list['count'] = count($arr); // 其他屬性

echo json_encode($list); // 輸出 json
// {"1":{"name":"zhangsan","age":22},"2":{"name":"lisi","age":25},"count":2}

而最后一種是比較常用的寫法，自定義字段和數組一起用，來修改下剛才例子。

$arr = $User->where($where)->find(); // 讀取數據

$list = [];
foreach($arr as $key => $val) { // 遍歷數組
  $list['list'][] = [ // 修改這里
    'name' => $val['name'],
    'age' => $val['age'],
  ];
}

$list['count'] = count($arr); // 其他屬性

echo json_encode($list); // 輸出 json
// {"list":[{"name":"zhangsan","age":22},{"name":"lisi","age":25}],"count":2}

OK，希望對剛入門的 phper 有所幫助。