PHP JSON

En este capítulo presentaremos cómo usar el lenguaje PHP para codificar y decodificar objetos JSON.

Configuración del entorno

En php5.2.0 y versiones superiores, la extensión JSON ya está incorporada.

Funciones JSON

FunciónDescripción
json_encode Codificar una variable en JSON
json_decodeDecodificar una cadena en formato JSON y convertirla en una variable PHP
json_last_errorDevolver el último error ocurrido

json_encode

PHP json_encode() se utiliza para codificar una variable en JSON. Esta función devuelve datos JSON si se ejecuta correctamente; de lo contrario, devuelve FALSE.

Sintaxis

string json_encode ( $value [, $options = 0 ] )

Parámetros

  • value: El valor a codificar. Esta función solo es válida para datos codificados en UTF-8.

  • options: Una máscara binaria compuesta por las siguientes constantes: 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_PRESERVE_ZERO_FRACTION, JSON_UNESCAPED_UNICODE, JSON_PARTIAL_OUTPUT_ON_ERROR.

    Es importante tener en cuenta la opción JSON_UNESCAPED_UNICODE: si no queremos que los caracteres chinos sean codificados, podemos añadir esta opción.

Ejemplo

El siguiente ejemplo muestra cómo convertir un array de PHP en datos en formato JSON:

<?php
   $arr = array('a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5);
   echo json_encode($arr);
?>

El resultado de ejecutar el código anterior es:

{"a":1,"b":2,"c":3,"d":4,"e":5}

El siguiente ejemplo muestra cómo convertir un objeto de PHP en datos en formato JSON:

Ejemplo

<?php
   class Emp {
       public $name = "";
       public $hobbies  = "";
       public $birthdate = "";
   }
   $e = new Emp();
   $e->name = "sachin";
   $e->hobbies  = "sports";
   $e->birthdate = date('m/d/Y h:i:s a', "8/5/1974 12:20:03 p");
   $e->birthdate = date('m/d/Y h:i:s a', strtotime("8/5/1974 12:20:03"));

   echo json_encode($e);
?>

El resultado de ejecutar el código anterior es:

{"name":"sachin","hobbies":"sports","birthdate":"08\/05\/1974 12:20:03 pm"}

Usar la opción JSON_UNESCAPED_UNICODE

<?php
   $arr = array('ejemplo' => 'Tutorial de Ejemplo', 'taobao' => 'Taobao');
   echo json_encode($arr); //Codificar chino
   echo PHP_EOL;  //Salto de línea
   echo json_encode($arr, JSON_UNESCAPED_UNICODE);  //No codificar chino
?>

El resultado de ejecutar el código anterior es:

{"ejemplo":"\u83dc\u9e1f\u6559\u7a0b","taobao":"\u6dd8\u5b9d\u7f51"}
{"ejemplo":"Ejemplo","taobao":"淘宝网"}

json_decode

La función PHP json_decode() se utiliza para decodificar una cadena en formato JSON y convertirla en una variable de PHP.

Sintaxis

mixed json_decode ($json_string [,$assoc = false [, $depth = 512 [, $options = 0 ]]])

Parámetros

  • json_string: La cadena JSON que se va a decodificar; debe ser datos codificados en UTF-8.

  • assoc: Cuando este parámetro es TRUE, devolverá un array; cuando es FALSE, devolverá un objeto.

  • depth: Un parámetro de tipo entero que especifica la profundidad de recursión.

  • options: Máscara binaria; actualmente solo admite JSON_BIGINT_AS_STRING.

Ejemplo

El siguiente ejemplo muestra cómo decodificar datos JSON:

Ejemplo

<?php
   $json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';

   var_dump(json_decode($json));
   var_dump(json_decode($json, true));
?>

El resultado de ejecutar el código anterior es:

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)
}
Otras extensiones