Quercus: JSON
From Resin 3.0
(→External links) |
|||
Line 121: | Line 121: | ||
*[http://en.wikipedia.org/wiki/JSON JSON Wikipedia entry] | *[http://en.wikipedia.org/wiki/JSON JSON Wikipedia entry] | ||
*[http://www.aurore.net/projects/php-json C Implementation from which Quercus' JSON syntax is based off of] | *[http://www.aurore.net/projects/php-json C Implementation from which Quercus' JSON syntax is based off of] | ||
+ | *[http://www.php.net/manual/en/ref.json.php As of PHP 5.2, PHP now has built-in support for json_decode/json_encode] |
Latest revision as of 21:14, 15 February 2007
JSON (JavaScript Object Notation) is a popular text data exchange format with built-in support from Quercus since Resin 3.0.20. One of the common uses of JSON in a PHP environment is for the server to send JSON data to the user's browser. Because the JSON language is a subset of JavaScript, JSON-encoded text can be readily parsed on the user's browser using JavaScript's eval()
function.
Contents |
Using JSON in Quercus
Quercus has built-in JSON support and JSON functionality is enabled the moment Quercus is started: no additional downloads are required. Quercus sports two PHP functions for working with JSON: json_encode
and json_decode
.
json_encode( object/array ) encodes any PHP array or object into JSON. json_decode( string, [, bool] ) decodes JSON into a PHP array or object.
json_decode
may return either a PHP array or object depending on the circumstances:
- If the text is that of a JSON array[1], decoding returns a non-associative PHP array.
- If the text is that of a JSON object and the second argument to
json_decode
is not specified or isfalse
, decoding returns a standard PHP object. - If the text is that of a JSON object and the second argument to
json_decode
istrue
, then decoding returns an associative PHP array.
Examples
json_encode
To encode an array into JSON:
<?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); ?>
The value of $json would be: '{"a":"Caucho", "b":"Resin", "c":"Quercus"}'
.
The JSON text may then be sent and used on the user's browser or to any client that can decode JSON.
json_decode
To decode JSON data into a standard PHP object in Quercus (using the above JSON text ($json
) as an example):
<?php $object = json_decode($json); ?>
$object
would be a standard PHP object with three fields "a", "b", and "c" with values "Caucho", "Resin", and "Quercus" respectively.
Simple Web Example
Below is a simple example using JSON on the web.
<script type="text/javascript"> <?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); echo "var data = $json;"; ?> var decoded = eval("(" + data + ")"); //Should output: "Quercus at work." document.write(decoded.c + " at work."); </script>
AJAX Example
JSON data is more commonly sent to the browser via AJAX requests. Suppose there are two files defined below. The PHP script in data.php encodes an array into JSON. When the user's browser is directed to index.html, an AJAX request receives JSON data from data.php. Then the browser calls eval()
on the JSON data to recover a JavaScript object.
data.php:
<?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); echo $json; ?>
index.html:
<html> <head> <script type="text/javascript"> var url = "data.php"; function request() { if (window.XMLHttpRequest) http_request = new XMLHttpRequest(); else http_request = new ActiveXObject("Microsoft.XMLHTTP"); http_request.onreadystatechange = function() { handle_json(http_request) }; http_request.open('GET', url, true); http_request.send(null); } function handle_json(http_request) { if (http_request.readyState == 4) { document.firstForm.json.value = http_request.responseText; var decoded = eval("(" + http_request.responseText + ")"); document.firstForm.decoded.value = decoded.a + "'s " + decoded.b + " with " + decoded.c + " at work."; } } function clearForm() { document.firstForm.json.value = ""; document.firstForm.decoded.value = ""; } </script> </head> <body> <form name="firstForm"> <p>JSON:<br><textarea name="json" cols="50"></textarea></p> <p>Decoded:<br><textarea name="decoded" cols="50"></textarea></p> <input type="button" onclick="request()" value="AJAX Request"> <input type="button" onclick="clearForm()" value="Clear"> </form> </body> </html>