API REST de tareas con un router propio

1<?php
2/** Una ruta: método, patrón con {parámetros} y la función que la atiende. */
3final class Ruta {
4    public function __construct(public string $metodo, public string $patron, public Closure $accion) {}
5
6    /** Los parámetros de la ruta si la URL encaja con el patrón, o null. */
7    public function encaja(string $ruta): ?array {
8        $regex = "#^" . preg_replace('#\{(\w+)\}#', '(?P<$1>[^/]+)', $this->patron) . "$#";
9        if (!preg_match($regex, $ruta, $m)) return null;
10        return array_filter($m, "is_string", ARRAY_FILTER_USE_KEY);
11    }
12}
13
14final class Respuesta {
15    public function __construct(public int $estado, public mixed $cuerpo = null) {}
16}
17
18final class Router {
19    /** @var Ruta[] */
20    private array $rutas = [];
21
22    public function add(string $metodo, string $patron, Closure $accion): void {
23        $this->rutas[] = new Ruta($metodo, $patron, $accion);
24    }
25
26    public function despachar(string $metodo, string $ruta, array $consulta, ?string $cuerpo): Respuesta {
27        $rutaExiste = false;
28        foreach ($this->rutas as $r) {
29            $params = $r->encaja($ruta);
30            if ($params === null) continue;
31            $rutaExiste = true;
32            if ($r->metodo === $metodo) return ($r->accion)($params, $consulta, $cuerpo);
33        }
34        // Si la ruta existe pero no con ese método, es 405, no 404
35        return $rutaExiste ? new Respuesta(405, ["error" => "Método no permitido"]) : new Respuesta(404, ["error" => "Ruta no encontrada"]);
36    }
37}
38
39$tareas = [];
40$siguiente = 1;
41const PRIORIDADES = ["alta", "media", "baja"];
42
43/** Valida los campos que vienen en $datos; con $nueva, el título es obligatorio. Devuelve los errores. */
44function validar(array $datos, bool $nueva): array {
45    $errores = [];
46    if ($nueva && !array_key_exists("titulo", $datos)) {
47        $errores["titulo"] = "obligatorio";
48    } elseif (array_key_exists("titulo", $datos) && (!is_string($datos["titulo"]) || mb_strlen(trim($datos["titulo"])) < 3 || mb_strlen(trim($datos["titulo"])) > 60)) {
49        $errores["titulo"] = "entre 3 y 60 caracteres";
50    }
51    if (array_key_exists("prioridad", $datos) && !in_array($datos["prioridad"], PRIORIDADES, true)) {
52        $errores["prioridad"] = "debe ser alta, media o baja";
53    }
54    if (array_key_exists("hecha", $datos) && !is_bool($datos["hecha"])) {
55        $errores["hecha"] = "debe ser true o false";
56    }
57    $permitidos = ["titulo", "prioridad", "hecha"];
58    foreach (array_diff(array_keys($datos), $permitidos) as $campo) $errores[$campo] = "campo desconocido";
59    return $errores;
60}
61
62/** El cuerpo JSON como array asociativo, o null si no es un objeto JSON. */
63function json(?string $cuerpo): ?array {
64    $datos = json_decode($cuerpo ?? "", true);
65    return is_array($datos) && !array_is_list($datos) ? $datos : (($cuerpo ?? "") === "{}" ? [] : null);
66}
67
68$router = new Router();
69
70$router->add("GET", "/api/tareas", function (array $p, array $q) use (&$tareas): Respuesta {
71    $lista = array_values($tareas);
72    if (isset($q["hecha"])) $lista = array_values(array_filter($lista, fn($t) => $t["hecha"] === ($q["hecha"] === "true")));
73    if (isset($q["q"])) $lista = array_values(array_filter($lista, fn($t) => mb_stripos($t["titulo"], $q["q"]) !== false));
74    return new Respuesta(200, $lista);
75});
76
77$router->add("POST", "/api/tareas", function (array $p, array $q, ?string $cuerpo) use (&$tareas, &$siguiente): Respuesta {
78    $datos = json($cuerpo);
79    if ($datos === null) return new Respuesta(400, ["error" => "JSON no válido"]);
80    if ($errores = validar($datos, true)) return new Respuesta(422, ["errores" => $errores]);
81    $tarea = ["id" => $siguiente++, "titulo" => trim($datos["titulo"]), "prioridad" => $datos["prioridad"] ?? "media", "hecha" => $datos["hecha"] ?? false];
82    $tareas[$tarea["id"]] = $tarea;
83    return new Respuesta(201, $tarea);
84});
85
86$router->add("GET", "/api/tareas/{id}", function (array $p) use (&$tareas): Respuesta {
87    return isset($tareas[$p["id"]]) ? new Respuesta(200, $tareas[$p["id"]]) : new Respuesta(404, ["error" => "No existe la tarea {$p['id']}"]);
88});
89
90$router->add("PATCH", "/api/tareas/{id}", function (array $p, array $q, ?string $cuerpo) use (&$tareas): Respuesta {
91    if (!isset($tareas[$p["id"]])) return new Respuesta(404, ["error" => "No existe la tarea {$p['id']}"]);
92    $datos = json($cuerpo);
93    if ($datos === null) return new Respuesta(400, ["error" => "JSON no válido"]);
94    if ($errores = validar($datos, false)) return new Respuesta(422, ["errores" => $errores]);
95    if (isset($datos["titulo"])) $datos["titulo"] = trim($datos["titulo"]);
96    $tareas[$p["id"]] = array_merge($tareas[$p["id"]], $datos);
97    return new Respuesta(200, $tareas[$p["id"]]);
98});
99
100$router->add("DELETE", "/api/tareas/{id}", function (array $p) use (&$tareas): Respuesta {
101    if (!isset($tareas[$p["id"]])) return new Respuesta(404, ["error" => "No existe la tarea {$p['id']}"]);
102    unset($tareas[$p["id"]]);
103    return new Respuesta(204);
104});
105
106foreach (explode("\n", stream_get_contents(STDIN)) as $linea) {
107    $linea = trim($linea);
108    if ($linea === "") continue;
109    $partes = explode(" ", $linea, 3);
110    if (count($partes) < 2) {
111        echo "Petición no válida\n";
112        continue;
113    }
114    [$metodo, $url] = $partes;
115    $ruta = parse_url($url, PHP_URL_PATH) ?? "";
116    parse_str(parse_url($url, PHP_URL_QUERY) ?? "", $consulta);
117    $r = $router->despachar(strtoupper($metodo), rtrim($ruta, "/") ?: "/", $consulta, $partes[2] ?? null);
118    $json = $r->cuerpo === null ? "" : " " . json_encode($r->cuerpo, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
119    echo strtoupper($metodo) . " $url → {$r->estado}$json\n";
120}