JSON com PHP

Este capítulo aborda como codificar e decodificar objetos JSON usando a linguagem de programação PHP. Vamos começar preparando o ambiente para iniciar nossa programação com PHP para JSON.

Meio Ambiente

A partir do PHP 5.2.0, a extensão JSON é agrupada e compilada no PHP por padrão.

Funções JSON

Função Bibliotecas
json_encode Retorna a representação JSON de um valor.
json_decode Decodifica uma string JSON.
json_last_error Retorna o último erro ocorrido.

Codificando JSON em PHP (json_encode)

A função PHP json_encode () é usada para codificar JSON em PHP. Esta função retorna a representação JSON de um valor em caso de sucesso ou FALSE em caso de falha.

Sintaxe

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

Parâmetros

  • value- O valor sendo codificado. Esta função só funciona com dados codificados em UTF-8.

  • options - Este valor opcional é um bitmask que consiste em JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_NUMERIC_CHECK, JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_FORCE_OBJECT.

Exemplo

O exemplo a seguir mostra como converter uma matriz em JSON com PHP -

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

Durante a execução, isso produzirá o seguinte resultado -

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

O exemplo a seguir mostra como os objetos PHP podem ser convertidos em JSON -

<?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);
?>

Durante a execução, isso produzirá o seguinte resultado -

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

Decodificando JSON em PHP (json_decode)

A função PHP json_decode () é usada para decodificar JSON em PHP. Esta função retorna o valor decodificado de json para o tipo de PHP apropriado.

Sintaxe

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

Paramaters

  • json_string - É uma string codificada que deve conter dados codificados em UTF-8.

  • assoc - É um parâmetro do tipo booleano, quando definido como TRUE, os objetos retornados serão convertidos em arrays associativos.

  • depth - É um parâmetro de tipo inteiro que especifica a profundidade da recursão

  • options - É uma máscara de bits do tipo inteiro de decodificação JSON, JSON_BIGINT_AS_STRING é compatível.

Exemplo

O exemplo a seguir mostra como o PHP pode ser usado para decodificar objetos JSON -

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

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

Durante a execução, ele produzirá o seguinte resultado -

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