PHP Mastery Tutorial 0/120 lessons ~6 min read Lesson 60

    JSON APIs

    JSON APIs is a single PHP idea you'll use in almost every backend project. In this lesson you learn only json apis — not five topics at once. By the end you can write a small wo…

    Course progress0%
    Focus
    12 guided sections
    Practice signal
    Examples included
    Career prep
    Interview Q&A included

    Quick Introduction

    JSON APIs is a single PHP idea you'll use in almost every backend project.

    In this lesson you learn only json apis — not five topics at once. By the end you can write a small working example and explain it in an interview.

    We connect each lesson to our course projects: Login System, Blog CMS, REST API, Inventory, Employee Management, and E-Commerce Backend.

    Business Problem

    You're building the REST API. After a user signs in, you need json apis working correctly before storing data or showing a dashboard.

    Without understanding JSON APIs, the team ships bugs: wrong totals, broken sessions, or type errors that only appear in production. This lesson fixes that with one clear pattern you can copy into your project today.

    Core Concept

    • JSON APIs is one focused idea — learn it before mixing with other PHP topics.
    • Use it in PHP 8.3+ with declare(strict_types=1); at the top of every file.
    • Our course project (REST API) uses json apis in real handlers.
    • Run small scripts with php file.php after each change — don't just read.
    • Interviewers ask for a one-minute explanation plus a tiny code sample.

    Syntax

    Core syntax for JSON APIs. Every keyword below appears in production PHP — Laravel and Symfony use the same primitives under the hood.

    php
    declare(strict_types=1);

    Keywords: declare · strict_types · namespace

    Step-by-Step Example

    Run this script locally. Change one value, run again, and watch what changes.

    php
    <?php
    declare(strict_types=1);
    header('Content-Type: application/json; charset=utf-8');
    $raw = file_get_contents('php://input') ?: '{}';
    if (!json_validate($raw)) {
    http_response_code(400);
    echo json_encode(['error' => 'Invalid JSON']);
    exit;
    }
    /** @var array{name?: string, qty?: int} $payload */
    $payload = json_decode($raw, true, flags: JSON_THROW_ON_ERROR);
    $name = trim($payload['name'] ?? '');
    $qty = max(1, (int)($payload['qty'] ?? 1));
    echo json_encode([
    'item' => ['name' => $name, 'qty' => $qty],
    'total' => $qty * 19.99,
    ], JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT);

    Line by line

    1. — part of the json apis example; run the file to see the result.
    2. declare(strict_types=1); — turns on strict type checking for this file.
    3. header('Content-Type: application/json; charset=utf-8'); — part of the json apis example; run the file to see the result.
    4. $raw = file_get_contents('php://input') ?: '{}'; — part of the json apis example; run the file to see the result.
    5. if (!json_validate($raw)) { — part of the json apis example; run the file to see the result.
    JSON APIs OK

    Real-World Example

    In the REST API, json apis appears in a single request handler — not spread across ten files. Keep the example small, test it with php, then paste the pattern into your project branch.

    That is how Laracasts-style learning works: one concept, one file, one win per lesson.

    Best Practices

    • One concept per file while learning json apis.
    • Start from the course code sample, change one line, re-run.
    • Name variables and functions clearly — $loginCount beats $x.
    • Use PHP 8.3 on your machine; match the version in production later.
    • Write a one-sentence comment at the top: what this script proves about json apis.

    Common Mistakes

    • Trying to learn json apis together with three other topics in one sitting — split them like this course does.
    • Skipping declare(strict_types=1); and getting silent type coercion bugs.
    • Copying code without running it — always execute with php your-file.php.
    • Using outdated PHP 5 tutorials (mysql_*, short tags) instead of PHP 8.3 docs.
    • Not connecting json apis to the course project — practice inside Login, Blog, or Inventory code.

    Hands-on Exercise

    Task: Create a file json_apis.php that demonstrates json apis for the REST API.

    Challenge: Add one edge case (empty input, zero, or invalid type) and print a friendly error message.

    php
    <?php
    declare(strict_types=1);
    // TODO: JSON APIs exercise for REST API

    Summary

    • JSON APIs is one concept — master it before combining with the next lesson.
    • Always use strict_types while learning PHP 8.3+.
    • Practice inside the REST API codebase as you progress.
    • Run code with php after every edit.
    • You can explain this topic in under two minutes with the sample script.
    • Next lesson builds on this — don't skip the exercise.

    Key Takeaways

    • You know what JSON APIs is and when to use it.
    • You can read and write the syntax from this lesson.
    • You ran the example and changed it successfully.
    • You can spot the five common mistakes listed above.
    • You answered at least three interview questions out loud.

    Interview Questions

    Q1BeginnerWhat is JSON APIs in PHP?
    JSON APIs lets you store and reuse values in PHP. In our REST API, it appears in small, testable scripts before we move code into classes.
    Q2BeginnerWhy use JSON APIs instead of a shortcut?
    Shortcuts hide bugs. JSON APIs makes behavior explicit so teammates and PHPStan can understand your code.
    Q3BeginnerShow a minimal JSON APIs example.
    Open this lesson's sample file, run it with php, and explain each line in plain English — that is enough for a junior interview.
    Q4BeginnerCommon beginner mistake with json apis?
    Mixing multiple new concepts in one file. Learn JSON APIs alone first, then combine in the course project.
    Q5BeginnerHow do you test json apis locally?
    Save a .php file, run php file.php, and compare output to what you expected. Add one PHPUnit test when you move code into a class.
    Ready to mark this lesson complete?Track your journey across the entire course.