How to Return JSON from a PHP Script

By the end of this page, you will understand how to send JSON responses from PHP correctly, why json_encode() is used, when to echo the output, and why setting the Content-Type: application/json header is important. You will also see common patterns used in APIs and AJAX endpoints.

JSON is a text format used to send structured data between systems. In PHP, you usually create an array or object, convert it to JSON with json_encode(), and send that JSON text as the response body.

A correct JSON response usually has two parts:

• The body, which contains the JSON string
• The HTTP headers, which tell the client what kind of data is being returned

In PHP, echo sends the response body. So yes, in most cases you do echo json_encode($data);.

You should also usually set the content type header:

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

This matters because browsers, JavaScript clients, mobile apps, and API consumers use headers to understand how to parse the response. If you skip the header, the JSON may still appear in the browser, but the client is not being told clearly that the response is JSON.

A common complete pattern looks like this:

header('Content-Type: application/json');
echo json_encode($data);

This concept matters in real programming because JSON is the standard format for:

• REST APIs
• AJAX requests
• Frontend-to-backend communication
• Returning status messages from server-side scripts
• Sending data to mobile or third-party clients

Think of an HTTP response like a package:

• The header is the label on the outside of the package
• The body is the actual content inside

If you send JSON from PHP:

• header('Content-Type: application/json') is the label saying "this package contains JSON"
• echo json_encode($data) is putting the actual JSON into the package

If you only send the body without the label, some clients may still figure it out, but it is less clear and less reliable.

Basic syntax

$data = ['name' => 'Alice', 'age' => 25];

header('Content-Type: application/json');
echo json_encode($data);

What this does

• $data is a PHP array
• json_encode($data) converts it into a JSON string
• header(...) tells the client the response is JSON
• echo sends the JSON to the browser or API client

Example output

{"name":"Alice","age":25}

Example with HTTP status code

$data = ['error' => 'User not found'];

http_response_code();
();
 ();

Consider this PHP code:

<?php
$user = [
    'id' => 1,
    'name' => 'Sam'
];

header('Content-Type: application/json');
echo json_encode($user);

Step-by-step

1. PHP creates the $user array:

   • id is 1
   • name is Sam

2. header('Content-Type: application/json'); adds an HTTP response header.

   • This tells the client that the response body should be treated as JSON.

3. json_encode($user) converts the PHP array into a JSON string:

{"id":1,

AJAX endpoints

A frontend JavaScript app might call a PHP script and expect JSON:

header('Content-Type: application/json');
echo json_encode(['success' => true]);

REST API responses

A PHP API often returns JSON for resources such as users, orders, or products.

header('Content-Type: application/json');
echo json_encode([
    'id' => 42,
    'email' => 'user@example.com'
]);

Form validation responses

Instead of reloading a page, a backend can return validation errors as JSON:

header('Content-Type: application/json');
echo json_encode([
    'success' => false,
    'errors' => ['Email is required']
]);

Background tools and integrations

Webhook handlers or internal services often return JSON status messages so other systems can process the result automatically.

In real projects, developers usually do more than just echo json_encode(...).

Common pattern: structured API response

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

echo json_encode([
    'success' => true,
    'data' => [
        'id' => 1,
        'name' => 'Alice'
    ]
]);

This gives responses a predictable structure.

Validation with early return

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

if (empty($_GET['id'])) {
    http_response_code(400);
    echo json_encode(['error' => 'Missing id']);
    exit;
}

This is a guard clause: stop early when input is invalid.

Error handling

header();

 {
     = [ => ];
     (, JSON_THROW_ON_ERROR);
}  (JsonException ) {
    ();
     ([ => ]);
}

1. Forgetting json_encode()

Broken code:

$data = ['name' => 'Alice'];
echo $data;

Why it fails:

• PHP arrays cannot be printed as JSON automatically
• You must convert them first

Correct code:

$data = ['name' => 'Alice'];
header('Content-Type: application/json');
echo json_encode($data);

2. Not setting the content type

echo json_encode(['ok' => true]);

This may still output JSON text, but the client is not explicitly told that it is JSON.

Better:

header('Content-Type: application/json');
echo json_encode([ => ]);

header('Content-Type: application/json');
echo json_encode($data);

Rules

• Use json_encode() to convert PHP data to JSON
• Use echo to send the JSON response body
• Set Content-Type: application/json before output
• Set HTTP status codes with http_response_code() when needed
• Avoid mixing JSON with plain text or HTML
• Consider exit; after output in endpoint scripts

Useful patterns

Success response

header('Content-Type: application/json');
echo json_encode(['success' => true]);

Error response

http_response_code(400);
header('Content-Type: application/json');
echo ([ => ]);

Do I need to use echo to return JSON in PHP?

Yes. json_encode() creates a JSON string, and echo sends that string in the response body.

Do I need to set the Content-Type header for JSON in PHP?

Yes, usually. Use header('Content-Type: application/json'); so clients know the response is JSON.

Can I return a PHP array directly as JSON?

No. You must convert it using json_encode() first.

What happens if I forget the JSON header?

The response may still contain JSON text, but the client is not clearly told how to interpret it.

Should I call exit after echoing JSON?

Often yes, especially in standalone endpoint scripts. It prevents accidental extra output.

How do I send a JSON error response in PHP?

Set an HTTP status code and return a JSON object:

http_response_code(404);
header('Content-Type: application/json');
echo json_encode(['error' => 'Not found']);

• json_encode() — Converts PHP arrays and objects into JSON strings.
• HTTP headers — Used to describe the response format and other metadata.
• HTTP status codes — Important for signaling success, client errors, and server errors.
• AJAX — JavaScript often expects JSON responses from PHP endpoints.
• REST APIs — JSON is the standard response format for many APIs.
• PHP arrays and associative arrays — These are commonly converted into JSON objects and arrays.
• Output buffering — Relevant when dealing with header timing and accidental output.
• Error handling in PHP — Useful when JSON encoding or request validation fails.