~canonical-sysadmins/wordpress/4.2.2

« back to all changes in this revision

Viewing changes to wp-includes/class-json.php

  • Committer: Jacek Nykis
  • Date: 2015-01-05 16:17:05 UTC
  • Revision ID: jacek.nykis@canonical.com-20150105161705-w544l1h5mcg7u4w9
Initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?php
 
2
if ( ! class_exists( 'Services_JSON' ) ) :
 
3
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
 
4
/**
 
5
 * Converts to and from JSON format.
 
6
 *
 
7
 * JSON (JavaScript Object Notation) is a lightweight data-interchange
 
8
 * format. It is easy for humans to read and write. It is easy for machines
 
9
 * to parse and generate. It is based on a subset of the JavaScript
 
10
 * Programming Language, Standard ECMA-262 3rd Edition - December 1999.
 
11
 * This feature can also be found in  Python. JSON is a text format that is
 
12
 * completely language independent but uses conventions that are familiar
 
13
 * to programmers of the C-family of languages, including C, C++, C#, Java,
 
14
 * JavaScript, Perl, TCL, and many others. These properties make JSON an
 
15
 * ideal data-interchange language.
 
16
 *
 
17
 * This package provides a simple encoder and decoder for JSON notation. It
 
18
 * is intended for use with client-side Javascript applications that make
 
19
 * use of HTTPRequest to perform server communication functions - data can
 
20
 * be encoded into JSON notation for use in a client-side javascript, or
 
21
 * decoded from incoming Javascript requests. JSON format is native to
 
22
 * Javascript, and can be directly eval()'ed with no further parsing
 
23
 * overhead
 
24
 *
 
25
 * All strings should be in ASCII or UTF-8 format!
 
26
 *
 
27
 * LICENSE: Redistribution and use in source and binary forms, with or
 
28
 * without modification, are permitted provided that the following
 
29
 * conditions are met: Redistributions of source code must retain the
 
30
 * above copyright notice, this list of conditions and the following
 
31
 * disclaimer. Redistributions in binary form must reproduce the above
 
32
 * copyright notice, this list of conditions and the following disclaimer
 
33
 * in the documentation and/or other materials provided with the
 
34
 * distribution.
 
35
 *
 
36
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
 
37
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 
38
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
 
39
 * NO EVENT SHALL CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 
40
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 
41
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 
42
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 
43
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
 
44
 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 
45
 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 
46
 * DAMAGE.
 
47
 *
 
48
 * @category
 
49
 * @package     Services_JSON
 
50
 * @author      Michal Migurski <mike-json@teczno.com>
 
51
 * @author      Matt Knapp <mdknapp[at]gmail[dot]com>
 
52
 * @author      Brett Stimmerman <brettstimmerman[at]gmail[dot]com>
 
53
 * @copyright   2005 Michal Migurski
 
54
 * @version     CVS: $Id: JSON.php 305040 2010-11-02 23:19:03Z alan_k $
 
55
 * @license     http://www.opensource.org/licenses/bsd-license.php
 
56
 * @link        http://pear.php.net/pepr/pepr-proposal-show.php?id=198
 
57
 */
 
58
 
 
59
/**
 
60
 * Marker constant for Services_JSON::decode(), used to flag stack state
 
61
 */
 
62
define('SERVICES_JSON_SLICE',   1);
 
63
 
 
64
/**
 
65
 * Marker constant for Services_JSON::decode(), used to flag stack state
 
66
 */
 
67
define('SERVICES_JSON_IN_STR',  2);
 
68
 
 
69
/**
 
70
 * Marker constant for Services_JSON::decode(), used to flag stack state
 
71
 */
 
72
define('SERVICES_JSON_IN_ARR',  3);
 
73
 
 
74
/**
 
75
 * Marker constant for Services_JSON::decode(), used to flag stack state
 
76
 */
 
77
define('SERVICES_JSON_IN_OBJ',  4);
 
78
 
 
79
/**
 
80
 * Marker constant for Services_JSON::decode(), used to flag stack state
 
81
 */
 
82
define('SERVICES_JSON_IN_CMT', 5);
 
83
 
 
84
/**
 
85
 * Behavior switch for Services_JSON::decode()
 
86
 */
 
87
define('SERVICES_JSON_LOOSE_TYPE', 16);
 
88
 
 
89
/**
 
90
 * Behavior switch for Services_JSON::decode()
 
91
 */
 
92
define('SERVICES_JSON_SUPPRESS_ERRORS', 32);
 
93
 
 
94
/**
 
95
 * Behavior switch for Services_JSON::decode()
 
96
 */
 
97
define('SERVICES_JSON_USE_TO_JSON', 64);
 
98
 
 
99
/**
 
100
 * Converts to and from JSON format.
 
101
 *
 
102
 * Brief example of use:
 
103
 *
 
104
 * <code>
 
105
 * // create a new instance of Services_JSON
 
106
 * $json = new Services_JSON();
 
107
 *
 
108
 * // convert a complexe value to JSON notation, and send it to the browser
 
109
 * $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
 
110
 * $output = $json->encode($value);
 
111
 *
 
112
 * print($output);
 
113
 * // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
 
114
 *
 
115
 * // accept incoming POST data, assumed to be in JSON notation
 
116
 * $input = file_get_contents('php://input', 1000000);
 
117
 * $value = $json->decode($input);
 
118
 * </code>
 
119
 */
 
120
class Services_JSON
 
121
{
 
122
   /**
 
123
    * constructs a new JSON instance
 
124
    *
 
125
    * @param    int     $use    object behavior flags; combine with boolean-OR
 
126
    *
 
127
    *                           possible values:
 
128
    *                           - SERVICES_JSON_LOOSE_TYPE:  loose typing.
 
129
    *                                   "{...}" syntax creates associative arrays
 
130
    *                                   instead of objects in decode().
 
131
    *                           - SERVICES_JSON_SUPPRESS_ERRORS:  error suppression.
 
132
    *                                   Values which can't be encoded (e.g. resources)
 
133
    *                                   appear as NULL instead of throwing errors.
 
134
    *                                   By default, a deeply-nested resource will
 
135
    *                                   bubble up with an error, so all return values
 
136
    *                                   from encode() should be checked with isError()
 
137
    *                           - SERVICES_JSON_USE_TO_JSON:  call toJSON when serializing objects
 
138
    *                                   It serializes the return value from the toJSON call rather 
 
139
    *                                   than the object it'self,  toJSON can return associative arrays, 
 
140
    *                                   strings or numbers, if you return an object, make sure it does
 
141
    *                                   not have a toJSON method, otherwise an error will occur.
 
142
    */
 
143
    function Services_JSON($use = 0)
 
144
    {
 
145
        $this->use = $use;
 
146
        $this->_mb_strlen            = function_exists('mb_strlen');
 
147
        $this->_mb_convert_encoding  = function_exists('mb_convert_encoding');
 
148
        $this->_mb_substr            = function_exists('mb_substr');
 
149
    }
 
150
    // private - cache the mbstring lookup results..
 
151
    var $_mb_strlen = false;
 
152
    var $_mb_substr = false;
 
153
    var $_mb_convert_encoding = false;
 
154
    
 
155
   /**
 
156
    * convert a string from one UTF-16 char to one UTF-8 char
 
157
    *
 
158
    * Normally should be handled by mb_convert_encoding, but
 
159
    * provides a slower PHP-only method for installations
 
160
    * that lack the multibye string extension.
 
161
    *
 
162
    * @param    string  $utf16  UTF-16 character
 
163
    * @return   string  UTF-8 character
 
164
    * @access   private
 
165
    */
 
166
    function utf162utf8($utf16)
 
167
    {
 
168
        // oh please oh please oh please oh please oh please
 
169
        if($this->_mb_convert_encoding) {
 
170
            return mb_convert_encoding($utf16, 'UTF-8', 'UTF-16');
 
171
        }
 
172
 
 
173
        $bytes = (ord($utf16{0}) << 8) | ord($utf16{1});
 
174
 
 
175
        switch(true) {
 
176
            case ((0x7F & $bytes) == $bytes):
 
177
                // this case should never be reached, because we are in ASCII range
 
178
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
179
                return chr(0x7F & $bytes);
 
180
 
 
181
            case (0x07FF & $bytes) == $bytes:
 
182
                // return a 2-byte UTF-8 character
 
183
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
184
                return chr(0xC0 | (($bytes >> 6) & 0x1F))
 
185
                     . chr(0x80 | ($bytes & 0x3F));
 
186
 
 
187
            case (0xFFFF & $bytes) == $bytes:
 
188
                // return a 3-byte UTF-8 character
 
189
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
190
                return chr(0xE0 | (($bytes >> 12) & 0x0F))
 
191
                     . chr(0x80 | (($bytes >> 6) & 0x3F))
 
192
                     . chr(0x80 | ($bytes & 0x3F));
 
193
        }
 
194
 
 
195
        // ignoring UTF-32 for now, sorry
 
196
        return '';
 
197
    }
 
198
 
 
199
   /**
 
200
    * convert a string from one UTF-8 char to one UTF-16 char
 
201
    *
 
202
    * Normally should be handled by mb_convert_encoding, but
 
203
    * provides a slower PHP-only method for installations
 
204
    * that lack the multibye string extension.
 
205
    *
 
206
    * @param    string  $utf8   UTF-8 character
 
207
    * @return   string  UTF-16 character
 
208
    * @access   private
 
209
    */
 
210
    function utf82utf16($utf8)
 
211
    {
 
212
        // oh please oh please oh please oh please oh please
 
213
        if($this->_mb_convert_encoding) {
 
214
            return mb_convert_encoding($utf8, 'UTF-16', 'UTF-8');
 
215
        }
 
216
 
 
217
        switch($this->strlen8($utf8)) {
 
218
            case 1:
 
219
                // this case should never be reached, because we are in ASCII range
 
220
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
221
                return $utf8;
 
222
 
 
223
            case 2:
 
224
                // return a UTF-16 character from a 2-byte UTF-8 char
 
225
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
226
                return chr(0x07 & (ord($utf8{0}) >> 2))
 
227
                     . chr((0xC0 & (ord($utf8{0}) << 6))
 
228
                         | (0x3F & ord($utf8{1})));
 
229
 
 
230
            case 3:
 
231
                // return a UTF-16 character from a 3-byte UTF-8 char
 
232
                // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
233
                return chr((0xF0 & (ord($utf8{0}) << 4))
 
234
                         | (0x0F & (ord($utf8{1}) >> 2)))
 
235
                     . chr((0xC0 & (ord($utf8{1}) << 6))
 
236
                         | (0x7F & ord($utf8{2})));
 
237
        }
 
238
 
 
239
        // ignoring UTF-32 for now, sorry
 
240
        return '';
 
241
    }
 
242
 
 
243
   /**
 
244
    * encodes an arbitrary variable into JSON format (and sends JSON Header)
 
245
    *
 
246
    * @param    mixed   $var    any number, boolean, string, array, or object to be encoded.
 
247
    *                           see argument 1 to Services_JSON() above for array-parsing behavior.
 
248
    *                           if var is a strng, note that encode() always expects it
 
249
    *                           to be in ASCII or UTF-8 format!
 
250
    *
 
251
    * @return   mixed   JSON string representation of input var or an error if a problem occurs
 
252
    * @access   public
 
253
    */
 
254
    function encode($var)
 
255
    {
 
256
        header('Content-type: application/json');
 
257
        return $this->encodeUnsafe($var);
 
258
    }
 
259
    /**
 
260
    * encodes an arbitrary variable into JSON format without JSON Header - warning - may allow XSS!!!!)
 
261
    *
 
262
    * @param    mixed   $var    any number, boolean, string, array, or object to be encoded.
 
263
    *                           see argument 1 to Services_JSON() above for array-parsing behavior.
 
264
    *                           if var is a strng, note that encode() always expects it
 
265
    *                           to be in ASCII or UTF-8 format!
 
266
    *
 
267
    * @return   mixed   JSON string representation of input var or an error if a problem occurs
 
268
    * @access   public
 
269
    */
 
270
    function encodeUnsafe($var)
 
271
    {
 
272
        // see bug #16908 - regarding numeric locale printing
 
273
        $lc = setlocale(LC_NUMERIC, 0);
 
274
        setlocale(LC_NUMERIC, 'C');
 
275
        $ret = $this->_encode($var);
 
276
        setlocale(LC_NUMERIC, $lc);
 
277
        return $ret;
 
278
        
 
279
    }
 
280
    /**
 
281
    * PRIVATE CODE that does the work of encodes an arbitrary variable into JSON format 
 
282
    *
 
283
    * @param    mixed   $var    any number, boolean, string, array, or object to be encoded.
 
284
    *                           see argument 1 to Services_JSON() above for array-parsing behavior.
 
285
    *                           if var is a strng, note that encode() always expects it
 
286
    *                           to be in ASCII or UTF-8 format!
 
287
    *
 
288
    * @return   mixed   JSON string representation of input var or an error if a problem occurs
 
289
    * @access   public
 
290
    */
 
291
    function _encode($var) 
 
292
    {
 
293
         
 
294
        switch (gettype($var)) {
 
295
            case 'boolean':
 
296
                return $var ? 'true' : 'false';
 
297
 
 
298
            case 'NULL':
 
299
                return 'null';
 
300
 
 
301
            case 'integer':
 
302
                return (int) $var;
 
303
 
 
304
            case 'double':
 
305
            case 'float':
 
306
                return  (float) $var;
 
307
 
 
308
            case 'string':
 
309
                // STRINGS ARE EXPECTED TO BE IN ASCII OR UTF-8 FORMAT
 
310
                $ascii = '';
 
311
                $strlen_var = $this->strlen8($var);
 
312
 
 
313
               /*
 
314
                * Iterate over every character in the string,
 
315
                * escaping with a slash or encoding to UTF-8 where necessary
 
316
                */
 
317
                for ($c = 0; $c < $strlen_var; ++$c) {
 
318
 
 
319
                    $ord_var_c = ord($var{$c});
 
320
 
 
321
                    switch (true) {
 
322
                        case $ord_var_c == 0x08:
 
323
                            $ascii .= '\b';
 
324
                            break;
 
325
                        case $ord_var_c == 0x09:
 
326
                            $ascii .= '\t';
 
327
                            break;
 
328
                        case $ord_var_c == 0x0A:
 
329
                            $ascii .= '\n';
 
330
                            break;
 
331
                        case $ord_var_c == 0x0C:
 
332
                            $ascii .= '\f';
 
333
                            break;
 
334
                        case $ord_var_c == 0x0D:
 
335
                            $ascii .= '\r';
 
336
                            break;
 
337
 
 
338
                        case $ord_var_c == 0x22:
 
339
                        case $ord_var_c == 0x2F:
 
340
                        case $ord_var_c == 0x5C:
 
341
                            // double quote, slash, slosh
 
342
                            $ascii .= '\\'.$var{$c};
 
343
                            break;
 
344
 
 
345
                        case (($ord_var_c >= 0x20) && ($ord_var_c <= 0x7F)):
 
346
                            // characters U-00000000 - U-0000007F (same as ASCII)
 
347
                            $ascii .= $var{$c};
 
348
                            break;
 
349
 
 
350
                        case (($ord_var_c & 0xE0) == 0xC0):
 
351
                            // characters U-00000080 - U-000007FF, mask 110XXXXX
 
352
                            // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
353
                            if ($c+1 >= $strlen_var) {
 
354
                                $c += 1;
 
355
                                $ascii .= '?';
 
356
                                break;
 
357
                            }
 
358
                            
 
359
                            $char = pack('C*', $ord_var_c, ord($var{$c + 1}));
 
360
                            $c += 1;
 
361
                            $utf16 = $this->utf82utf16($char);
 
362
                            $ascii .= sprintf('\u%04s', bin2hex($utf16));
 
363
                            break;
 
364
 
 
365
                        case (($ord_var_c & 0xF0) == 0xE0):
 
366
                            if ($c+2 >= $strlen_var) {
 
367
                                $c += 2;
 
368
                                $ascii .= '?';
 
369
                                break;
 
370
                            }
 
371
                            // characters U-00000800 - U-0000FFFF, mask 1110XXXX
 
372
                            // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
373
                            $char = pack('C*', $ord_var_c,
 
374
                                         @ord($var{$c + 1}),
 
375
                                         @ord($var{$c + 2}));
 
376
                            $c += 2;
 
377
                            $utf16 = $this->utf82utf16($char);
 
378
                            $ascii .= sprintf('\u%04s', bin2hex($utf16));
 
379
                            break;
 
380
 
 
381
                        case (($ord_var_c & 0xF8) == 0xF0):
 
382
                            if ($c+3 >= $strlen_var) {
 
383
                                $c += 3;
 
384
                                $ascii .= '?';
 
385
                                break;
 
386
                            }
 
387
                            // characters U-00010000 - U-001FFFFF, mask 11110XXX
 
388
                            // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
389
                            $char = pack('C*', $ord_var_c,
 
390
                                         ord($var{$c + 1}),
 
391
                                         ord($var{$c + 2}),
 
392
                                         ord($var{$c + 3}));
 
393
                            $c += 3;
 
394
                            $utf16 = $this->utf82utf16($char);
 
395
                            $ascii .= sprintf('\u%04s', bin2hex($utf16));
 
396
                            break;
 
397
 
 
398
                        case (($ord_var_c & 0xFC) == 0xF8):
 
399
                            // characters U-00200000 - U-03FFFFFF, mask 111110XX
 
400
                            // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
401
                            if ($c+4 >= $strlen_var) {
 
402
                                $c += 4;
 
403
                                $ascii .= '?';
 
404
                                break;
 
405
                            }
 
406
                            $char = pack('C*', $ord_var_c,
 
407
                                         ord($var{$c + 1}),
 
408
                                         ord($var{$c + 2}),
 
409
                                         ord($var{$c + 3}),
 
410
                                         ord($var{$c + 4}));
 
411
                            $c += 4;
 
412
                            $utf16 = $this->utf82utf16($char);
 
413
                            $ascii .= sprintf('\u%04s', bin2hex($utf16));
 
414
                            break;
 
415
 
 
416
                        case (($ord_var_c & 0xFE) == 0xFC):
 
417
                        if ($c+5 >= $strlen_var) {
 
418
                                $c += 5;
 
419
                                $ascii .= '?';
 
420
                                break;
 
421
                            }
 
422
                            // characters U-04000000 - U-7FFFFFFF, mask 1111110X
 
423
                            // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
424
                            $char = pack('C*', $ord_var_c,
 
425
                                         ord($var{$c + 1}),
 
426
                                         ord($var{$c + 2}),
 
427
                                         ord($var{$c + 3}),
 
428
                                         ord($var{$c + 4}),
 
429
                                         ord($var{$c + 5}));
 
430
                            $c += 5;
 
431
                            $utf16 = $this->utf82utf16($char);
 
432
                            $ascii .= sprintf('\u%04s', bin2hex($utf16));
 
433
                            break;
 
434
                    }
 
435
                }
 
436
                return  '"'.$ascii.'"';
 
437
 
 
438
            case 'array':
 
439
               /*
 
440
                * As per JSON spec if any array key is not an integer
 
441
                * we must treat the the whole array as an object. We
 
442
                * also try to catch a sparsely populated associative
 
443
                * array with numeric keys here because some JS engines
 
444
                * will create an array with empty indexes up to
 
445
                * max_index which can cause memory issues and because
 
446
                * the keys, which may be relevant, will be remapped
 
447
                * otherwise.
 
448
                *
 
449
                * As per the ECMA and JSON specification an object may
 
450
                * have any string as a property. Unfortunately due to
 
451
                * a hole in the ECMA specification if the key is a
 
452
                * ECMA reserved word or starts with a digit the
 
453
                * parameter is only accessible using ECMAScript's
 
454
                * bracket notation.
 
455
                */
 
456
 
 
457
                // treat as a JSON object
 
458
                if (is_array($var) && count($var) && (array_keys($var) !== range(0, sizeof($var) - 1))) {
 
459
                    $properties = array_map(array($this, 'name_value'),
 
460
                                            array_keys($var),
 
461
                                            array_values($var));
 
462
 
 
463
                    foreach($properties as $property) {
 
464
                        if(Services_JSON::isError($property)) {
 
465
                            return $property;
 
466
                        }
 
467
                    }
 
468
 
 
469
                    return '{' . join(',', $properties) . '}';
 
470
                }
 
471
 
 
472
                // treat it like a regular array
 
473
                $elements = array_map(array($this, '_encode'), $var);
 
474
 
 
475
                foreach($elements as $element) {
 
476
                    if(Services_JSON::isError($element)) {
 
477
                        return $element;
 
478
                    }
 
479
                }
 
480
 
 
481
                return '[' . join(',', $elements) . ']';
 
482
 
 
483
            case 'object':
 
484
            
 
485
                // support toJSON methods.
 
486
                if (($this->use & SERVICES_JSON_USE_TO_JSON) && method_exists($var, 'toJSON')) {
 
487
                    // this may end up allowing unlimited recursion
 
488
                    // so we check the return value to make sure it's not got the same method.
 
489
                    $recode = $var->toJSON();
 
490
                    
 
491
                    if (method_exists($recode, 'toJSON')) {
 
492
                        
 
493
                        return ($this->use & SERVICES_JSON_SUPPRESS_ERRORS)
 
494
                        ? 'null'
 
495
                        : new Services_JSON_Error(get_class($var).
 
496
                            " toJSON returned an object with a toJSON method.");
 
497
                            
 
498
                    }
 
499
                    
 
500
                    return $this->_encode( $recode );
 
501
                } 
 
502
                
 
503
                $vars = get_object_vars($var);
 
504
                
 
505
                $properties = array_map(array($this, 'name_value'),
 
506
                                        array_keys($vars),
 
507
                                        array_values($vars));
 
508
 
 
509
                foreach($properties as $property) {
 
510
                    if(Services_JSON::isError($property)) {
 
511
                        return $property;
 
512
                    }
 
513
                }
 
514
 
 
515
                return '{' . join(',', $properties) . '}';
 
516
 
 
517
            default:
 
518
                return ($this->use & SERVICES_JSON_SUPPRESS_ERRORS)
 
519
                    ? 'null'
 
520
                    : new Services_JSON_Error(gettype($var)." can not be encoded as JSON string");
 
521
        }
 
522
    }
 
523
 
 
524
   /**
 
525
    * array-walking function for use in generating JSON-formatted name-value pairs
 
526
    *
 
527
    * @param    string  $name   name of key to use
 
528
    * @param    mixed   $value  reference to an array element to be encoded
 
529
    *
 
530
    * @return   string  JSON-formatted name-value pair, like '"name":value'
 
531
    * @access   private
 
532
    */
 
533
    function name_value($name, $value)
 
534
    {
 
535
        $encoded_value = $this->_encode($value);
 
536
 
 
537
        if(Services_JSON::isError($encoded_value)) {
 
538
            return $encoded_value;
 
539
        }
 
540
 
 
541
        return $this->_encode(strval($name)) . ':' . $encoded_value;
 
542
    }
 
543
 
 
544
   /**
 
545
    * reduce a string by removing leading and trailing comments and whitespace
 
546
    *
 
547
    * @param    $str    string      string value to strip of comments and whitespace
 
548
    *
 
549
    * @return   string  string value stripped of comments and whitespace
 
550
    * @access   private
 
551
    */
 
552
    function reduce_string($str)
 
553
    {
 
554
        $str = preg_replace(array(
 
555
 
 
556
                // eliminate single line comments in '// ...' form
 
557
                '#^\s*//(.+)$#m',
 
558
 
 
559
                // eliminate multi-line comments in '/* ... */' form, at start of string
 
560
                '#^\s*/\*(.+)\*/#Us',
 
561
 
 
562
                // eliminate multi-line comments in '/* ... */' form, at end of string
 
563
                '#/\*(.+)\*/\s*$#Us'
 
564
 
 
565
            ), '', $str);
 
566
 
 
567
        // eliminate extraneous space
 
568
        return trim($str);
 
569
    }
 
570
 
 
571
   /**
 
572
    * decodes a JSON string into appropriate variable
 
573
    *
 
574
    * @param    string  $str    JSON-formatted string
 
575
    *
 
576
    * @return   mixed   number, boolean, string, array, or object
 
577
    *                   corresponding to given JSON input string.
 
578
    *                   See argument 1 to Services_JSON() above for object-output behavior.
 
579
    *                   Note that decode() always returns strings
 
580
    *                   in ASCII or UTF-8 format!
 
581
    * @access   public
 
582
    */
 
583
    function decode($str)
 
584
    {
 
585
        $str = $this->reduce_string($str);
 
586
 
 
587
        switch (strtolower($str)) {
 
588
            case 'true':
 
589
                return true;
 
590
 
 
591
            case 'false':
 
592
                return false;
 
593
 
 
594
            case 'null':
 
595
                return null;
 
596
 
 
597
            default:
 
598
                $m = array();
 
599
 
 
600
                if (is_numeric($str)) {
 
601
                    // Lookie-loo, it's a number
 
602
 
 
603
                    // This would work on its own, but I'm trying to be
 
604
                    // good about returning integers where appropriate:
 
605
                    // return (float)$str;
 
606
 
 
607
                    // Return float or int, as appropriate
 
608
                    return ((float)$str == (integer)$str)
 
609
                        ? (integer)$str
 
610
                        : (float)$str;
 
611
 
 
612
                } elseif (preg_match('/^("|\').*(\1)$/s', $str, $m) && $m[1] == $m[2]) {
 
613
                    // STRINGS RETURNED IN UTF-8 FORMAT
 
614
                    $delim = $this->substr8($str, 0, 1);
 
615
                    $chrs = $this->substr8($str, 1, -1);
 
616
                    $utf8 = '';
 
617
                    $strlen_chrs = $this->strlen8($chrs);
 
618
 
 
619
                    for ($c = 0; $c < $strlen_chrs; ++$c) {
 
620
 
 
621
                        $substr_chrs_c_2 = $this->substr8($chrs, $c, 2);
 
622
                        $ord_chrs_c = ord($chrs{$c});
 
623
 
 
624
                        switch (true) {
 
625
                            case $substr_chrs_c_2 == '\b':
 
626
                                $utf8 .= chr(0x08);
 
627
                                ++$c;
 
628
                                break;
 
629
                            case $substr_chrs_c_2 == '\t':
 
630
                                $utf8 .= chr(0x09);
 
631
                                ++$c;
 
632
                                break;
 
633
                            case $substr_chrs_c_2 == '\n':
 
634
                                $utf8 .= chr(0x0A);
 
635
                                ++$c;
 
636
                                break;
 
637
                            case $substr_chrs_c_2 == '\f':
 
638
                                $utf8 .= chr(0x0C);
 
639
                                ++$c;
 
640
                                break;
 
641
                            case $substr_chrs_c_2 == '\r':
 
642
                                $utf8 .= chr(0x0D);
 
643
                                ++$c;
 
644
                                break;
 
645
 
 
646
                            case $substr_chrs_c_2 == '\\"':
 
647
                            case $substr_chrs_c_2 == '\\\'':
 
648
                            case $substr_chrs_c_2 == '\\\\':
 
649
                            case $substr_chrs_c_2 == '\\/':
 
650
                                if (($delim == '"' && $substr_chrs_c_2 != '\\\'') ||
 
651
                                   ($delim == "'" && $substr_chrs_c_2 != '\\"')) {
 
652
                                    $utf8 .= $chrs{++$c};
 
653
                                }
 
654
                                break;
 
655
 
 
656
                            case preg_match('/\\\u[0-9A-F]{4}/i', $this->substr8($chrs, $c, 6)):
 
657
                                // single, escaped unicode character
 
658
                                $utf16 = chr(hexdec($this->substr8($chrs, ($c + 2), 2)))
 
659
                                       . chr(hexdec($this->substr8($chrs, ($c + 4), 2)));
 
660
                                $utf8 .= $this->utf162utf8($utf16);
 
661
                                $c += 5;
 
662
                                break;
 
663
 
 
664
                            case ($ord_chrs_c >= 0x20) && ($ord_chrs_c <= 0x7F):
 
665
                                $utf8 .= $chrs{$c};
 
666
                                break;
 
667
 
 
668
                            case ($ord_chrs_c & 0xE0) == 0xC0:
 
669
                                // characters U-00000080 - U-000007FF, mask 110XXXXX
 
670
                                //see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
671
                                $utf8 .= $this->substr8($chrs, $c, 2);
 
672
                                ++$c;
 
673
                                break;
 
674
 
 
675
                            case ($ord_chrs_c & 0xF0) == 0xE0:
 
676
                                // characters U-00000800 - U-0000FFFF, mask 1110XXXX
 
677
                                // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
678
                                $utf8 .= $this->substr8($chrs, $c, 3);
 
679
                                $c += 2;
 
680
                                break;
 
681
 
 
682
                            case ($ord_chrs_c & 0xF8) == 0xF0:
 
683
                                // characters U-00010000 - U-001FFFFF, mask 11110XXX
 
684
                                // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
685
                                $utf8 .= $this->substr8($chrs, $c, 4);
 
686
                                $c += 3;
 
687
                                break;
 
688
 
 
689
                            case ($ord_chrs_c & 0xFC) == 0xF8:
 
690
                                // characters U-00200000 - U-03FFFFFF, mask 111110XX
 
691
                                // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
692
                                $utf8 .= $this->substr8($chrs, $c, 5);
 
693
                                $c += 4;
 
694
                                break;
 
695
 
 
696
                            case ($ord_chrs_c & 0xFE) == 0xFC:
 
697
                                // characters U-04000000 - U-7FFFFFFF, mask 1111110X
 
698
                                // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8
 
699
                                $utf8 .= $this->substr8($chrs, $c, 6);
 
700
                                $c += 5;
 
701
                                break;
 
702
 
 
703
                        }
 
704
 
 
705
                    }
 
706
 
 
707
                    return $utf8;
 
708
 
 
709
                } elseif (preg_match('/^\[.*\]$/s', $str) || preg_match('/^\{.*\}$/s', $str)) {
 
710
                    // array, or object notation
 
711
 
 
712
                    if ($str{0} == '[') {
 
713
                        $stk = array(SERVICES_JSON_IN_ARR);
 
714
                        $arr = array();
 
715
                    } else {
 
716
                        if ($this->use & SERVICES_JSON_LOOSE_TYPE) {
 
717
                            $stk = array(SERVICES_JSON_IN_OBJ);
 
718
                            $obj = array();
 
719
                        } else {
 
720
                            $stk = array(SERVICES_JSON_IN_OBJ);
 
721
                            $obj = new stdClass();
 
722
                        }
 
723
                    }
 
724
 
 
725
                    array_push($stk, array('what'  => SERVICES_JSON_SLICE,
 
726
                                           'where' => 0,
 
727
                                           'delim' => false));
 
728
 
 
729
                    $chrs = $this->substr8($str, 1, -1);
 
730
                    $chrs = $this->reduce_string($chrs);
 
731
 
 
732
                    if ($chrs == '') {
 
733
                        if (reset($stk) == SERVICES_JSON_IN_ARR) {
 
734
                            return $arr;
 
735
 
 
736
                        } else {
 
737
                            return $obj;
 
738
 
 
739
                        }
 
740
                    }
 
741
 
 
742
                    //print("\nparsing {$chrs}\n");
 
743
 
 
744
                    $strlen_chrs = $this->strlen8($chrs);
 
745
 
 
746
                    for ($c = 0; $c <= $strlen_chrs; ++$c) {
 
747
 
 
748
                        $top = end($stk);
 
749
                        $substr_chrs_c_2 = $this->substr8($chrs, $c, 2);
 
750
 
 
751
                        if (($c == $strlen_chrs) || (($chrs{$c} == ',') && ($top['what'] == SERVICES_JSON_SLICE))) {
 
752
                            // found a comma that is not inside a string, array, etc.,
 
753
                            // OR we've reached the end of the character list
 
754
                            $slice = $this->substr8($chrs, $top['where'], ($c - $top['where']));
 
755
                            array_push($stk, array('what' => SERVICES_JSON_SLICE, 'where' => ($c + 1), 'delim' => false));
 
756
                            //print("Found split at {$c}: ".$this->substr8($chrs, $top['where'], (1 + $c - $top['where']))."\n");
 
757
 
 
758
                            if (reset($stk) == SERVICES_JSON_IN_ARR) {
 
759
                                // we are in an array, so just push an element onto the stack
 
760
                                array_push($arr, $this->decode($slice));
 
761
 
 
762
                            } elseif (reset($stk) == SERVICES_JSON_IN_OBJ) {
 
763
                                // we are in an object, so figure
 
764
                                // out the property name and set an
 
765
                                // element in an associative array,
 
766
                                // for now
 
767
                                $parts = array();
 
768
                                
 
769
                               if (preg_match('/^\s*(["\'].*[^\\\]["\'])\s*:/Uis', $slice, $parts)) {
 
770
                                      // "name":value pair
 
771
                                    $key = $this->decode($parts[1]);
 
772
                                    $val = $this->decode(trim(substr($slice, strlen($parts[0])), ", \t\n\r\0\x0B"));
 
773
                                    if ($this->use & SERVICES_JSON_LOOSE_TYPE) {
 
774
                                        $obj[$key] = $val;
 
775
                                    } else {
 
776
                                        $obj->$key = $val;
 
777
                                    }
 
778
                                } elseif (preg_match('/^\s*(\w+)\s*:/Uis', $slice, $parts)) {
 
779
                                    // name:value pair, where name is unquoted
 
780
                                    $key = $parts[1];
 
781
                                    $val = $this->decode(trim(substr($slice, strlen($parts[0])), ", \t\n\r\0\x0B"));
 
782
 
 
783
                                    if ($this->use & SERVICES_JSON_LOOSE_TYPE) {
 
784
                                        $obj[$key] = $val;
 
785
                                    } else {
 
786
                                        $obj->$key = $val;
 
787
                                    }
 
788
                                }
 
789
 
 
790
                            }
 
791
 
 
792
                        } elseif ((($chrs{$c} == '"') || ($chrs{$c} == "'")) && ($top['what'] != SERVICES_JSON_IN_STR)) {
 
793
                            // found a quote, and we are not inside a string
 
794
                            array_push($stk, array('what' => SERVICES_JSON_IN_STR, 'where' => $c, 'delim' => $chrs{$c}));
 
795
                            //print("Found start of string at {$c}\n");
 
796
 
 
797
                        } elseif (($chrs{$c} == $top['delim']) &&
 
798
                                 ($top['what'] == SERVICES_JSON_IN_STR) &&
 
799
                                 (($this->strlen8($this->substr8($chrs, 0, $c)) - $this->strlen8(rtrim($this->substr8($chrs, 0, $c), '\\'))) % 2 != 1)) {
 
800
                            // found a quote, we're in a string, and it's not escaped
 
801
                            // we know that it's not escaped becase there is _not_ an
 
802
                            // odd number of backslashes at the end of the string so far
 
803
                            array_pop($stk);
 
804
                            //print("Found end of string at {$c}: ".$this->substr8($chrs, $top['where'], (1 + 1 + $c - $top['where']))."\n");
 
805
 
 
806
                        } elseif (($chrs{$c} == '[') &&
 
807
                                 in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) {
 
808
                            // found a left-bracket, and we are in an array, object, or slice
 
809
                            array_push($stk, array('what' => SERVICES_JSON_IN_ARR, 'where' => $c, 'delim' => false));
 
810
                            //print("Found start of array at {$c}\n");
 
811
 
 
812
                        } elseif (($chrs{$c} == ']') && ($top['what'] == SERVICES_JSON_IN_ARR)) {
 
813
                            // found a right-bracket, and we're in an array
 
814
                            array_pop($stk);
 
815
                            //print("Found end of array at {$c}: ".$this->substr8($chrs, $top['where'], (1 + $c - $top['where']))."\n");
 
816
 
 
817
                        } elseif (($chrs{$c} == '{') &&
 
818
                                 in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) {
 
819
                            // found a left-brace, and we are in an array, object, or slice
 
820
                            array_push($stk, array('what' => SERVICES_JSON_IN_OBJ, 'where' => $c, 'delim' => false));
 
821
                            //print("Found start of object at {$c}\n");
 
822
 
 
823
                        } elseif (($chrs{$c} == '}') && ($top['what'] == SERVICES_JSON_IN_OBJ)) {
 
824
                            // found a right-brace, and we're in an object
 
825
                            array_pop($stk);
 
826
                            //print("Found end of object at {$c}: ".$this->substr8($chrs, $top['where'], (1 + $c - $top['where']))."\n");
 
827
 
 
828
                        } elseif (($substr_chrs_c_2 == '/*') &&
 
829
                                 in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) {
 
830
                            // found a comment start, and we are in an array, object, or slice
 
831
                            array_push($stk, array('what' => SERVICES_JSON_IN_CMT, 'where' => $c, 'delim' => false));
 
832
                            $c++;
 
833
                            //print("Found start of comment at {$c}\n");
 
834
 
 
835
                        } elseif (($substr_chrs_c_2 == '*/') && ($top['what'] == SERVICES_JSON_IN_CMT)) {
 
836
                            // found a comment end, and we're in one now
 
837
                            array_pop($stk);
 
838
                            $c++;
 
839
 
 
840
                            for ($i = $top['where']; $i <= $c; ++$i)
 
841
                                $chrs = substr_replace($chrs, ' ', $i, 1);
 
842
 
 
843
                            //print("Found end of comment at {$c}: ".$this->substr8($chrs, $top['where'], (1 + $c - $top['where']))."\n");
 
844
 
 
845
                        }
 
846
 
 
847
                    }
 
848
 
 
849
                    if (reset($stk) == SERVICES_JSON_IN_ARR) {
 
850
                        return $arr;
 
851
 
 
852
                    } elseif (reset($stk) == SERVICES_JSON_IN_OBJ) {
 
853
                        return $obj;
 
854
 
 
855
                    }
 
856
 
 
857
                }
 
858
        }
 
859
    }
 
860
 
 
861
    /**
 
862
     * @todo Ultimately, this should just call PEAR::isError()
 
863
     */
 
864
    function isError($data, $code = null)
 
865
    {
 
866
        if (class_exists('pear')) {
 
867
            return PEAR::isError($data, $code);
 
868
        } elseif (is_object($data) && (get_class($data) == 'services_json_error' ||
 
869
                                 is_subclass_of($data, 'services_json_error'))) {
 
870
            return true;
 
871
        }
 
872
 
 
873
        return false;
 
874
    }
 
875
    
 
876
    /**
 
877
    * Calculates length of string in bytes
 
878
    * @param string 
 
879
    * @return integer length
 
880
    */
 
881
    function strlen8( $str ) 
 
882
    {
 
883
        if ( $this->_mb_strlen ) {
 
884
            return mb_strlen( $str, "8bit" );
 
885
        }
 
886
        return strlen( $str );
 
887
    }
 
888
    
 
889
    /**
 
890
    * Returns part of a string, interpreting $start and $length as number of bytes.
 
891
    * @param string 
 
892
    * @param integer start 
 
893
    * @param integer length 
 
894
    * @return integer length
 
895
    */
 
896
    function substr8( $string, $start, $length=false ) 
 
897
    {
 
898
        if ( $length === false ) {
 
899
            $length = $this->strlen8( $string ) - $start;
 
900
        }
 
901
        if ( $this->_mb_substr ) {
 
902
            return mb_substr( $string, $start, $length, "8bit" );
 
903
        }
 
904
        return substr( $string, $start, $length );
 
905
    }
 
906
 
 
907
}
 
908
 
 
909
if (class_exists('PEAR_Error')) {
 
910
 
 
911
    class Services_JSON_Error extends PEAR_Error
 
912
    {
 
913
        function Services_JSON_Error($message = 'unknown error', $code = null,
 
914
                                     $mode = null, $options = null, $userinfo = null)
 
915
        {
 
916
            parent::PEAR_Error($message, $code, $mode, $options, $userinfo);
 
917
        }
 
918
    }
 
919
 
 
920
} else {
 
921
 
 
922
    /**
 
923
     * @todo Ultimately, this class shall be descended from PEAR_Error
 
924
     */
 
925
    class Services_JSON_Error
 
926
    {
 
927
        function Services_JSON_Error($message = 'unknown error', $code = null,
 
928
                                     $mode = null, $options = null, $userinfo = null)
 
929
        {
 
930
 
 
931
        }
 
932
    }
 
933
    
 
934
}
 
935
 
 
936
endif;