This PHP library create a wrapper for json_encode and json_decode PHP functions
that normalize use across de PHP versions and throw exceptions when encoding or
decoding fail.
This library require PHP 5.3.3 or higher
You can use Composer to use this library in your application.
If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:
curl -s http://getcomposer.org/installer | php
And then execute this command to add libary to your project:
$ composer require sgmendez/json
Or require sgmendez/json
into your composer.json file:
json
{
"require": {
"sgmendez/json": "*"
}
}
You can run the PHPUnit tests, in directory test execute:
$ php phpunit.phar .
In this directory there are a copy of phpunit.phar for execution test
Encode JSON data:
php
use Sgmendez\Json\Json;
$json = new Json();
try
{
$arrayData = array('foo' => 'Foo', 'bar' => 'Bar');
$jsonData = $json->encode($arrayData);
}
catch (Exception $ex)
{
echo '[EXCEPTION] MSG: '.$ex->getMessage().' | FILE: '.$ex->getFile().': '.$ex->getLine()."\n";
}
Decode JSON string (by default, return array data):
php
use Sgmendez\Json\Json;
$json = new Json();
try
{
$jsonData = '{"foo":"Foo","bar":"Bar"}';
$dataArray = $json->decode($jsonData);
}
catch (Exception $ex)
{
echo '[EXCEPTION] MSG: '.$ex->getMessage() .
' | FILE: '.$ex->getFile().': '.$ex->getLine()."\n";
}
Decode JSON file (by default, return array data):
php
use Sgmendez\Json\Json;
$json = new Json();
try
{
$dataArray = $json->decodeFile('/path/to/file.json');
}
catch (Exception $ex)
{
echo '[EXCEPTION] MSG: '.$ex->getMessage() .
' | FILE: '.$ex->getFile().': '.$ex->getLine()."\n";
}
If you need to check if is valid json data, you can to use checkValidJsonData() method.
Licensed under the BSD License: