PHP - PHP JSON Processing

Introduction

JSON, which stands for JavaScript Object Notation, is a lightweight data format widely used for storing and exchanging information between applications. Although JSON originated from JavaScript, it is language-independent and is supported by PHP, Java, Python, C#, JavaScript, and many other programming languages.

In PHP applications, JSON is especially important when working with web APIs, AJAX requests, mobile applications, frontend frameworks, and communication between different systems.

PHP provides built-in functions for converting PHP data into JSON and converting JSON data back into PHP data. The two most important functions are:

json_encode() — converts PHP data into a JSON string.
json_decode() — converts a JSON string into PHP data.

Why JSON Is Used in PHP

JSON is commonly used because it is:

Lightweight and easy to transfer over a network
Human-readable
Easy for programming languages to process
Well suited for REST APIs
Commonly used in AJAX communication
Capable of representing objects, arrays, strings, numbers, Boolean values, and null values

For example, a JSON representation of a student may look like:

{
    "name": "Rahul",
    "age": 21,
    "course": "PHP"
}

The same information can be represented in PHP as an associative array:

$student = [
    "name" => "Rahul",
    "age" => 21,
    "course" => "PHP"
];

PHP can convert this array into JSON using json_encode().

Converting PHP Data into JSON

The json_encode() function converts a PHP value into its JSON representation.

Syntax:

json_encode($value);

Example:

$student = [
    "name" => "Rahul",
    "age" => 21,
    "course" => "PHP"
];

$jsonData = json_encode($student);

echo $jsonData;

Output:

{"name":"Rahul","age":21,"course":"PHP"}

Here, $student is a PHP associative array. The json_encode() function converts it into a JSON object.

Converting Multiple Records into JSON

PHP arrays containing multiple associative arrays can also be converted into JSON.

$students = [
    [
        "name" => "Rahul",
        "age" => 21
    ],
    [
        "name" => "Priya",
        "age" => 22
    ],
    [
        "name" => "Arun",
        "age" => 20
    ]
];

$jsonData = json_encode($students);

echo $jsonData;

Output:

[
    {"name":"Rahul","age":21},
    {"name":"Priya","age":22},
    {"name":"Arun","age":20}
]

This type of structure is frequently returned by PHP-based APIs.

Pretty-Printing JSON

By default, JSON generated by PHP is compact. For example:

{"name":"Rahul","age":21,"course":"PHP"}

For easier reading during development, the JSON_PRETTY_PRINT option can be used.

$student = [
    "name" => "Rahul",
    "age" => 21,
    "course" => "PHP"
];

echo json_encode($student, JSON_PRETTY_PRINT);

Output:

{
    "name": "Rahul",
    "age": 21,
    "course": "PHP"
}

Pretty printing is useful for debugging and examining API responses.

Converting JSON into PHP Data

The json_decode() function converts a JSON string into a PHP value.

Syntax:

json_decode($json);

Example:

$jsonData = '{"name":"Rahul","age":21,"course":"PHP"}';

$student = json_decode($jsonData);

echo $student->name;
echo $student->age;

Output:

Rahul
21

By default, json_decode() converts a JSON object into a PHP object.

Converting JSON into an Associative Array

The second argument of json_decode() can be set to true to convert JSON objects into associative arrays.

$jsonData = '{"name":"Rahul","age":21,"course":"PHP"}';

$student = json_decode($jsonData, true);

echo $student["name"];
echo $student["age"];

Output:

Rahul
21

This is particularly useful when you prefer PHP array syntax instead of object notation.

Handling Nested JSON

JSON can contain nested objects and arrays.

Example:

{
    "name": "Rahul",
    "contact": {
        "email": "[email protected]",
        "phone": "9876543210"
    }
}

PHP can process this structure using json_decode().

$jsonData = '{
    "name": "Rahul",
    "contact": {
        "email": "[email protected]",
        "phone": "9876543210"
    }
}';

$student = json_decode($jsonData);

echo $student->name;
echo $student->contact->email;
echo $student->contact->phone;

The nested contact object can therefore be accessed through the main PHP object.

JSON Arrays

JSON arrays are represented using square brackets.

Example:

{
    "name": "Rahul",
    "skills": [
        "PHP",
        "MySQL",
        "JavaScript"
    ]
}

PHP can access the values after decoding:

$jsonData = '{
    "name": "Rahul",
    "skills": ["PHP", "MySQL", "JavaScript"]
}';

$student = json_decode($jsonData);

echo $student->skills[0];
echo $student->skills[1];
echo $student->skills[2];

Output:

PHP
MySQL
JavaScript

JSON Data Types

JSON supports several basic data types:

JSON Type	Example
String	`"PHP"`
Number	`25`
Boolean	`true`
Null	`null`
Object	`{"name":"Rahul"}`
Array	`["PHP","JavaScript"]`

PHP automatically converts compatible PHP values into their corresponding JSON representations.

For example:

$data = [
    "name" => "Rahul",
    "age" => 25,
    "active" => true,
    "address" => null
];

echo json_encode($data, JSON_PRETTY_PRINT);

The result will contain a JSON string with the corresponding string, number, Boolean, and null values.

Checking JSON Errors

Invalid JSON can cause decoding problems. PHP provides json_last_error() to identify the most recent JSON error.

Example:

$jsonData = '{"name":"Rahul", "age":}';

$data = json_decode($jsonData);

if (json_last_error() !== JSON_ERROR_NONE) {
    echo "Invalid JSON";
}

This allows the application to detect whether the JSON was successfully processed.

Using `JSON_THROW_ON_ERROR`

Modern PHP applications can use JSON_THROW_ON_ERROR to make JSON error handling more explicit.

Example:

$jsonData = '{"name":"Rahul", "age":}';

try {
    $data = json_decode(
        $jsonData,
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    print_r($data);
} catch (JsonException $e) {
    echo "JSON Error: " . $e->getMessage();
}

Instead of silently returning a failure value, PHP throws a JsonException, which can then be handled using try and catch.

JSON and PHP APIs

JSON is particularly important when developing APIs.

Suppose a PHP API needs to return student information:

header("Content-Type: application/json");

$student = [
    "id" => 101,
    "name" => "Rahul",
    "course" => "PHP"
];

echo json_encode($student);

The Content-Type header tells the client that the response contains JSON.

The response could be:

{
    "id": 101,
    "name": "Rahul",
    "course": "PHP"
}

A frontend application, mobile application, or another server can then process this JSON response.

Receiving JSON from a Request

PHP applications often receive JSON from frontend applications or other APIs.

The request body can be accessed using php://input.

Example:

$input = file_get_contents("php://input");

$data = json_decode($input, true);

echo $data["name"];

If the client sends:

{
    "name": "Rahul",
    "course": "PHP"
}

PHP can decode the request and access individual values.

JSON and AJAX

JSON is frequently used with AJAX because a webpage can communicate with a PHP server without completely reloading the page.

For example, JavaScript can send a request to a PHP script:

fetch("student.php")
    .then(response => response.json())
    .then(data => {
        console.log(data.name);
    });

The PHP file can return:

header("Content-Type: application/json");

echo json_encode([
    "name" => "Rahul",
    "course" => "PHP"
]);

The JavaScript application receives the JSON response and can use the individual values.

Important JSON Functions in PHP

Some commonly used JSON-related functions and constants include:

Function/Constant	Purpose
`json_encode()`	Converts PHP data into JSON
`json_decode()`	Converts JSON into PHP data
`json_last_error()`	Returns the last JSON error
`json_last_error_msg()`	Returns a readable JSON error message
`JSON_PRETTY_PRINT`	Formats JSON for readability
`JSON_THROW_ON_ERROR`	Causes JSON errors to throw an exception

Practical Example

The following example demonstrates encoding and decoding together:

<?php

$student = [
    "id" => 101,
    "name" => "Rahul",
    "course" => "PHP",
    "skills" => [
        "PHP",
        "MySQL",
        "JavaScript"
    ]
];

$jsonData = json_encode($student, JSON_PRETTY_PRINT);

echo "JSON Data:\n";
echo $jsonData;

echo "\n\n";

$decodedData = json_decode($jsonData, true);

echo "Student Name: " . $decodedData["name"] . "\n";
echo "Course: " . $decodedData["course"] . "\n";
echo "First Skill: " . $decodedData["skills"][0];
?>

This example demonstrates the complete cycle:

PHP Array
    |
    | json_encode()
    v
JSON String
    |
    | json_decode()
    v
PHP Array

Advantages of JSON Processing in PHP

JSON processing provides several benefits:

Simple data exchange
PHP applications can exchange structured data easily with other applications.
API compatibility
JSON is one of the most common formats used by modern web APIs.
Easy conversion
PHP provides built-in functions for encoding and decoding JSON.
Lightweight format
JSON generally requires less structural overhead than formats such as XML.
Frontend integration
JSON works naturally with JavaScript and modern frontend frameworks.
Support for nested structures
Objects and arrays can be combined to represent complex data.

Common Mistakes

One common mistake is confusing a JSON string with a PHP array.

For example:

$json = '{"name":"Rahul"}';

Here, $json is a string, not an associative array. It must first be decoded:

$data = json_decode($json, true);

Another common mistake is attempting to access an object as an array:

$data = json_decode($json);

echo $data["name"];

Since the default result is an object, this should instead be:

echo $data->name;

Alternatively, decode it as an associative array:

$data = json_decode($json, true);

echo $data["name"];

Conclusion

PHP JSON processing provides a straightforward way to exchange structured information between PHP applications and other systems. The two fundamental operations are encoding PHP data into JSON using json_encode() and decoding JSON into PHP data using json_decode().

Understanding JSON processing is essential for PHP developers working with REST APIs, AJAX applications, frontend frameworks, mobile applications, and distributed systems. Proper error handling with json_last_error() or JSON_THROW_ON_ERROR is also important when processing JSON received from external sources.

PHP - PHP JSON Processing

Introduction

Why JSON Is Used in PHP

Converting PHP Data into JSON

Converting Multiple Records into JSON

Pretty-Printing JSON

Converting JSON into PHP Data

Converting JSON into an Associative Array

Handling Nested JSON

JSON Arrays

JSON Data Types

Checking JSON Errors

Using JSON_THROW_ON_ERROR

JSON and PHP APIs

Receiving JSON from a Request

JSON and AJAX

Important JSON Functions in PHP

Practical Example

Advantages of JSON Processing in PHP

Common Mistakes

Conclusion

Using `JSON_THROW_ON_ERROR`