PHP JSON
什么是 JSON ?
· JSON 指的是 JavaScript 對(duì)象表示法(JavaScript Object Notation)
· JSON 是輕量級(jí)的文本數(shù)據(jù)交換格式
· JSON 獨(dú)立于語言 *
· JSON 具有自我描述性,更易理解
* JSON 使用 JavaScript 語法來描述數(shù)據(jù)對(duì)象,但是 JSON 仍然獨(dú)立于語言和平臺(tái)。JSON 解析器和 JSON 庫支持許多不同的編程語言。
環(huán)境配置
在 php5.2.0 及以上版本已經(jīng)內(nèi)置 JSON 擴(kuò)展。
JSON 函數(shù)
函數(shù) | 描述 |
json_encode | 對(duì)變量進(jìn)行 JSON 編碼 |
json_decode | 對(duì) JSON 格式的字符串進(jìn)行解碼,轉(zhuǎn)換為 PHP 變量 |
json_last_error | 返回最后發(fā)生的錯(cuò)誤 |
json_encode
json_encode() 用于對(duì)變量進(jìn)行 JSON 編碼,該函數(shù)如果執(zhí)行成功返回 JSON 數(shù)據(jù),否則返回 FALSE 。
語法
json_encode ($value,[,options = 0 ] )
參數(shù)
· value: 要編碼的值。該函數(shù)只對(duì) UTF-8 編碼的數(shù)據(jù)有效。
· options:由以下常量組成的二進(jìn)制掩碼:JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_NUMERIC_CHECK,JSON_PRETTY_PRINT,
JSON_UNESCAPED_SLASHES, JSON_FORCE_OBJECT
· 由于json只接受utf-8編碼的字符,所以json_encode()的參數(shù)必須是utf-8編碼,否則會(huì)得到空字符或者null。當(dāng)中文使用GB2312編碼,或者外文使用ISO-8859-1編碼的時(shí)
候,這一點(diǎn)要特別注意。
實(shí)例
以下實(shí)例演示了如何將 PHP 數(shù)組轉(zhuǎn)換為 JSON 格式數(shù)據(jù):
<?php $arr = array('a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5); echo json_encode($arr); ?>
程序運(yùn)行結(jié)果:
{"a":1,"b":2,"c":3,"d":4,"e":5}
以下實(shí)例演示了如何將 PHP 對(duì)象轉(zhuǎn)換為JSON 格式數(shù)據(jù)
<?php class Emp { public $name = ""; public $hobbies = ""; public $birthdate = ""; } $e = new Emp(); $e->name = "sachin"; $e->hobbies = "sports"; $e->birthdate = date('Y-m-d h:i:s a', "2016/9/19 12:20:03 p"); $e->birthdate = date('Y-m-d h:i:s a', strtotime("2016/9/19 12:20:03")); echo json_encode($e); ?>
程序運(yùn)行結(jié)果:
{"name":"sachin","hobbies":"sports","birthdate":"2016-09-19 12:20:03 pm"} $json [,$assoc = false [, $depth = 512 [, $options = 0 ]]]
json_decode
json_decode() 函數(shù)用于對(duì) JSON 格式的字符串進(jìn)行解碼,并轉(zhuǎn)換為 PHP 變量。
語法
json_decode ($json [,$assoc = false [, $depth = 512 [, $options = 0 ]]])
參數(shù)
· json_string: 待解碼的 JSON 字符串,必須是 UTF-8 編碼數(shù)據(jù)
· assoc: 當(dāng)該參數(shù)為 TRUE 時(shí),將返回?cái)?shù)組,F(xiàn)ALSE 時(shí)返回對(duì)象。
· depth: 整數(shù)類型的參數(shù),它指定遞歸深度
· options: 二進(jìn)制掩碼,目前只支持 JSON_BIGINT_AS_STRING 。
json_decode()的常見錯(cuò)誤
下面三種json寫法都是錯(cuò)的,你能看出錯(cuò)在哪里嗎?
$bad_json = "{ 'bar': 'baz' }";
$bad_json = '{ bar: "baz" }';$bad_json = '{ "bar": "baz", }';
對(duì)這三個(gè)字符串執(zhí)行json_decode()都將返回null,并且報(bào)錯(cuò)。
第一個(gè)的錯(cuò)誤是,json的分隔符(delimiter)只允許使用雙引號(hào),不能使用單引號(hào)。
第二個(gè)的錯(cuò)誤是,json名值對(duì)的"名"(冒號(hào)左邊的部分),任何情況下都必須使用雙引號(hào)。
第三個(gè)的錯(cuò)誤是,最后一個(gè)值之后不能添加逗號(hào)(trailing comma)。
另外,json只能用來表示對(duì)象(object)和數(shù)組(array),如果對(duì)一個(gè)字符串或數(shù)值使用json_decode(),將會(huì)返回null。
實(shí)例
以下實(shí)例演示了如何解碼 JSON 數(shù)據(jù):
<?php $json = '{"a":1,"b":2,"c":3,"d":4,"e":5}'; var_dump(json_decode($json)); var_dump(json_decode($json, true)); ?>
程序運(yùn)行結(jié)果:
object(stdClass)#1 (5) { ["a"]=> int(1) ["b"]=> int(2) ["c"]=> int(3) ["d"]=> int(4) ["e"]=> int(5)}array(5) { ["a"]=> int(1) ["b"]=> int(2) ["c"]=> int(3) ["d"]=> int(4) ["e"]=> int(5)}