حدود HTTP وJSON API القابلة للصيانة

<?php
declare(strict_types=1);
function decodeCourse(string $json): array {
    $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (!is_array($data) || !isset($data["title"], $data["seats"]) ||
        !is_string($data["title"]) || trim($data["title"]) === "" ||
        !is_int($data["seats"]) || $data["seats"] < 0) {
        throw new InvalidArgumentException("invalid course shape");
    }
    return ["title" => trim($data["title"]), "seats" => $data["seats"]];
}
$course = decodeCourse('{"title":" PHP ","seats":2}');
echo $course["title"], " ", $course["seats"], PHP_EOL;

PHP 2

يحوي المعاد الحقول المختارة الصالحة فقط؛ ولا يضمنها JSON الصحيح وحده.

<?php
declare(strict_types=1);
function readResponse(array $courses, int $id): array {
    if (!array_key_exists($id, $courses)) {
        return ["status" => 404, "body" => ["error" => "course_missing"]];
    }
    return ["status" => 200, "body" => ["id" => $id, "title" => $courses[$id]["title"]]];
}
$courses = [1 => ["title" => "PHP", "internalNote" => "synthetic private field"]];
echo json_encode(readResponse($courses, 1), JSON_THROW_ON_ERROR), PHP_EOL;
echo json_encode(readResponse($courses, 2), JSON_THROW_ON_ERROR), PHP_EOL;

{"status":200,"body":{"id":1,"title":"PHP"}}
{"status":404,"body":{"error":"course_missing"}}

لا تكشف الملاحظة الداخلية؛ والأعداد نموذج قرار لا إرسال HTTP.