Working with JSON in PHP: Parsing and Serialization for Beginners

Introduction to Working with JSON in PHP

JSON (JavaScript Object Notation) is a lightweight data interchange format widely used in web development for transferring information between a client and a server. Despite its origins in JavaScript, JSON has become a universal standard supported by virtually all programming languages, including PHP.

In PHP, working with JSON is implemented natively, making processing this format simple and efficient. In this article, we will thoroughly examine how to perform JSON parsing (converting a string into PHP data structures) and serialization (converting PHP data into a JSON string). The material is aimed at beginner developers, so we will progress from simple to complex.

By the end of the article, you will learn:

\n
• Convert PHP arrays and objects to JSON
\n
• Parse JSON strings into associative arrays and objects
\n
• Handle errors when working with JSON
\n
• Use nested data structures
\n

Basic Functions for Working with JSON in PHP

PHP provides two main functions for working with JSON:

json_encode() — Data Serialization

The json_encode() function converts a PHP variable (array, object, string, number) into a JSON string. This is called serialization.

Basic usage example:

<?php\n// Associative array\n$user = [\n    "name" => "Ivan",\n    "age" => 28,\n    "email" => "ivan@example.com",\n    "is_active" => true\n];\n\n$json = json_encode($user);\necho $json;\n// Output: {"name":"Ivan","age":28,"email":"ivan@example.com","is_active":true}\n?>

The function automatically converts PHP data types to corresponding JSON types:

\n
• Strings → JSON strings
\n
• Numbers → JSON numbers
\n
• Boolean values → true/false
\n
• Arrays → JSON objects or arrays (depends on keys)
\n
• NULL → null
\n

json_decode() — JSON Parsing

The json_decode() function performs the reverse operation — it converts a JSON string into a PHP variable. This is called parsing.

Example:

<?php\n$jsonString = '{"name":"Ivan","age":28,"email":"ivan@example.com","is_active":true}';\n\n// Parse into an object (default)\n$userObject = json_decode($jsonString);\necho $userObject->name; // Output: Ivan\n\n// Parse into an associative array (second parameter true)\n$userArray = json_decode($jsonString, true);\necho $userArray["name"]; // Output: Ivan\n?>

Note the second parameter of the json_decode() function:

\n
• false (default) — returns stdClass objects
\n
• true — returns associative arrays
\n

Advanced Features and Error Handling

Working with Nested Structures

JSON supports nested objects and arrays. PHP handles such structures easily:

<?php\n// Complex data structure\n$data = [\n    "company" => "TechCorp",\n    "employees" => [\n        ["name" => "Anna", "position" => "Developer"],\n        ["name" => "Peter", "position" => "Designer"],\n        ["name" => "Maria", "position" => "Manager"]\n    ],\n    "address" => [\n        "city" => "Moscow",\n        "street" => "Tverskaya",\n        "building" => 10\n    ]\n];\n\n$json = json_encode($data, JSON_PRETTY_PRINT);\necho $json;\n?>

The result will be formatted for readability thanks to the JSON_PRETTY_PRINT flag.

Error Handling During Parsing

When working with external data (API, files), it is important to check that the JSON is valid. Use the json_last_error() function:

<?php\n$badJson = '{"name":