Tema 10 · PUT, PATCH & DELETE

10. Endpoints PUT/PATCH y DELETE: Actualización Total/Parcial y Eliminación Limpia

Gestiona la actualización de recursos verificando existencia previa y la eliminación de registros respondiendo con HTTP 200 o 204 No Content.

Actualizaciones y Eliminaciones en REST

Para modificar o suprimir un recurso, la convención REST dicta que la URI debe contener el identificador único del recurso objetivo (por ejemplo: PUT /api/productos/14 o DELETE /api/productos/14).

El Flujo de Verificación Previa (Check Existence)

Antes de ejecutar un UPDATE o un DELETE, una API profesional verifica si el recurso existe:

  • Si el ID no existe en la base de datos, responde de inmediato con HTTP 404 Not Found.
  • Si existe, procede con la actualización y devuelve el objeto resultante con HTTP 200 OK.
  • Para eliminaciones, se puede devolver HTTP 200 OK con un mensaje confirmatorio o HTTP 204 No Content sin cuerpo de respuesta.

⚡ Controlador de Actualización Parcial (PATCH) y Eliminación (DELETE)

Implementación en PHP nativo para modificar dinámicamente campos enviados y borrar registros:

ProductoControladorUpdateDelete.php
Solo lectura
<?php
declare(strict_types=1);

final class ProductoControladorUpdateDelete
{
    /**
     * PATCH /api/productos/{id}
     */
    public function actualizar(int $id): void
    {
        $db = Database::getConnection();

        // 1. Comprobar que el producto exista
        $check = $db->prepare('SELECT id FROM productos WHERE id = :id');
        $check->execute(['id' => $id]);
        if (!$check->fetch()) {
            ApiResponse::error("Producto con ID $id no encontrado", 404);
        }

        $payload = json_decode(file_get_contents('php://input'), true) ?? [];
        $camposPermitidos = ['nombre', 'precio', 'stock'];
        $camposAActualizar = [];
        $parametros = ['id' => $id];

        // 2. Construir dinámicamente la sentencia UPDATE solo con los campos recibidos
        foreach ($camposPermitidos as $campo) {
            if (array_key_exists($campo, $payload)) {
                $camposAActualizar[] = "$campo = :$campo";
                $parametros[$campo] = $payload[$campo];
            }
        }

        if (empty($camposAActualizar)) {
            ApiResponse::error('No se enviaron campos válidos para actualizar', 400);
        }

        $sql = 'UPDATE productos SET ' . implode(', ', $camposAActualizar) . ' WHERE id = :id';
        $stmt = $db->prepare($sql);
        $stmt->execute($parametros);

        ApiResponse::success(null, "Producto con ID $id actualizado con éxito");
    }

    /**
     * DELETE /api/productos/{id}
     */
    public function eliminar(int $id): void
    {
        $db = Database::getConnection();

        // 1. Verificar existencia
        $check = $db->prepare('SELECT id FROM productos WHERE id = :id');
        $check->execute(['id' => $id]);
        if (!$check->fetch()) {
            ApiResponse::error("Producto con ID $id no encontrado para eliminar", 404);
        }

        // 2. Ejecutar borrado
        $stmt = $db->prepare('DELETE FROM productos WHERE id = :id');
        $stmt->execute(['id' => $id]);

        // 3. Responder con 200 OK o 204 No Content
        ApiResponse::success(null, "Producto $id eliminado permanentemente");
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
Si un cliente intenta ejecutar DELETE /api/productos/99 pero el producto con ID 99 no existe en la base de datos, ¿qué código HTTP debe responder la API?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con PHP Puro, JSON & JWT y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.