PHP json_decode(): Decode JSON as an Associative Array

By the end of this page, you will understand why json_decode() returns a stdClass object by default, how to request an associative array, and how to safely validate and access decoded JSON data in PHP.

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

A JSON object uses curly braces:

{
  "Result": "success",
  "count": 3
}

By default, PHP converts JSON objects into instances of stdClass, a generic PHP object:

$data = json_decode($json);

That means its properties must be read with object syntax:

echo $data->Result;

The error occurs because this code uses array syntax:

$obj['Result']

Square brackets work only with arrays. They do not work with a stdClass object.

If you want PHP associative arrays instead, pass true as the second argument to json_decode():

Think of decoded JSON as a set of labeled storage containers.

• An object is like a filing cabinet: open a drawer using its label with ->.

  $data->Result
  

• An associative array is like a dictionary: look up an entry using a key in square brackets.

  $data['Result']
  

Both can represent the same JSON data. The important rule is to use the access style that matches the type you received.

Use the second argument of json_decode() to choose whether JSON objects become associative arrays.

json_decode(string $json, bool|null $associative = null): mixed

Decode JSON as an object (default)

$json = '{"Result":"success","count":3}';

$data = json_decode($json);

echo $data->Result; // success
echo $data->count;  // 3

Decode JSON as an associative array

$json = '{"Result":"success","count":3}';

$data = json_decode($json, true);

echo $data['Result']; // success
echo $data['count'];  

Consider this JSON response:

$json = '{"Result":{"status":"ok","items":["pen","book"]}}';

Decode it as an associative array:

$data = json_decode($json, true);

$status = $data['Result']['status'];
$firstItem = $data['Result']['items'][0];

echo $status;
echo $firstItem;

Step by step:

1. $json contains text in JSON format.
2. json_decode($json, true) converts the outer JSON object into a PHP array.
3. The Result key contains another JSON object, which also becomes an associative array.
4. status is read with ['status'].
5. items is a JSON list, so it becomes an indexed PHP array.
6. Index 0 accesses the first item, .

Decoding JSON as associative arrays is common when your code already works heavily with PHP arrays.

• API responses: Read a weather API response with $weather['current']['temperature'].
• Configuration files: Load JSON settings such as $config['database']['host'].
• Form or webhook payloads: Inspect incoming data and validate required keys.
• Data imports: Loop through a JSON list of products, orders, or users.
• Command-line scripts: Decode JSON output from another command and process fields by key.

For example, processing products returned by an API:

$json = '[{"name":"Keyboard","price":49.99},{"name":"Mouse","price":19.99}]';
$products = json_decode($json, true);

foreach ($products as $product) {
    echo $product['name'] . ': $' . $product['price'] . PHP_EOL;
}

In production code, decoding JSON is usually paired with error handling and validation.

Prefer exceptions for invalid JSON

JSON_THROW_ON_ERROR makes malformed JSON fail immediately with a JsonException instead of silently returning null.

try {
    $data = json_decode($jsonData, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $exception) {
    error_log('Invalid JSON: ' . $exception->getMessage());
    $data = [];
}

Use guard clauses before accessing required data

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

if (!isset($data['Result'])) {
    throw new RuntimeException('Response does not contain a Result field.');
}

 = [];

Using array syntax on the default decoded object

This causes the error in the question:

$data = json_decode('{"Result":"success"}');
echo $data['Result']; // Error: stdClass cannot be used as an array

Fix it by either using object syntax:

echo $data->Result;

Or decoding as an array:

$data = json_decode('{"Result":"success"}', true);
echo $data['Result'];

Using object syntax after requesting an array

$data = json_decode('{"Result":"success"}', true);
echo $data->Result; // Warning/error: array access must use brackets

Use this instead:

 [];

-> versus []

// JSON object -> stdClass object (default)
$data = json_decode($json);
echo $data->Result;

// JSON object -> associative array
$data = json_decode($json, true);
echo $data['Result'];

// Recommended when invalid JSON must fail clearly
$data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);

• JSON {} becomes stdClass by default.
• Pass true to make JSON objects associative arrays.
• Use -> for objects.
• Use ['key'] for associative arrays.
• JSON lists [] become indexed PHP arrays.
• Check that downloads succeed before decoding them.
• Use JSON_THROW_ON_ERROR for dependable JSON error handling.
• Verify optional keys with isset($data['key']) before reading them.

Why does json_decode() return stdClass?

PHP decodes JSON objects into stdClass objects by default. This lets you access JSON properties with ->.

How do I make json_decode() return an associative array?

Pass true as the second argument:

$data = json_decode($json, true);

Should I use objects or associative arrays for JSON in PHP?

Either is valid. Choose arrays when your code uses bracket access and PHP array functions. Choose objects when property access is clearer. Do not mix their access syntax.

What does the second argument of json_decode() do?

It controls how JSON objects are decoded. true produces associative arrays; the default produces stdClass objects.

What happens if the JSON is invalid?

Without special flags, json_decode() usually returns null. Use JSON_THROW_ON_ERROR to receive a instead.

• PHP associative arrays — The array type used when json_decode() receives true.
• PHP objects and stdClass — The default representation of JSON objects after decoding.
• PHP array access syntax — Explains named keys such as $data['Result'] and numeric indexes.
• PHP object property access — Explains property access with syntax such as $data->Result.
• json_encode() — Converts PHP arrays and objects back into JSON strings.
• Exception handling in PHP — Useful with JSON_THROW_ON_ERROR and failed network requests.
• PHP file_get_contents() — A simple way to retrieve a JSON file, with failure checks.
• API response validation — Helps ensure expected JSON fields exist before code uses them.