Tema 7 · Persistencia & PDO

7. Conexión Segura con PDO: Singleton, Parámetros y Prevención de Inyección SQL

Configura una conexión robusta a MySQL/MariaDB con PDO en modo de excepciones, juego de caracteres UTF-8 y consultas preparadas (Prepared Statements).

PDO (PHP Data Objects) como Estándar de la Industria

Para que una API RESTful interactúe con la base de datos de manera segura y eficiente en PHP moderno, PDO es la capa de abstracción oficial. A diferencia de las funciones antiguas u obsoletas, PDO soporta sentencias preparadas nativas (Prepared Statements) que impiden al 100% los ataques de Inyección SQL (SQLi).

Opciones Críticas de Configuración de PDO

Atributo PDO Configuración Recomendada Por qué es Vital
ATTR_ERRMODE ERRMODE_EXCEPTION Lanza excepciones PDOException reales cuando una consulta falla, permitiendo capturar el error sin que el script continúe a ciegas.
ATTR_DEFAULT_FETCH_MODE FETCH_ASSOC Devuelve los resultados como arrays asociativos indexados por nombre de columna, formato directamente compatible con json_encode().
ATTR_EMULATE_PREPARES false Desactiva la emulación local y fuerza a que el motor MySQL realice la preparación real de la consulta, blindando los parámetros tipados.

⚡ Clase Database Singleton con PDO para APIs REST

Patrón Singleton para reutilizar una única conexión a la base de datos a lo largo de todo el ciclo de vida de la petición HTTP:

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

final class Database
{
    private static ?PDO $instancia = null;

    private function __construct() {}
    private function __clone() {}

    /**
     * Obtiene la instancia única de conexión PDO.
     */
    public static function getConnection(): PDO
    {
        if (self::$instancia === null) {
            $host    = getenv('DB_HOST') ?: '127.0.0.1';
            $puerto  = getenv('DB_PORT') ?: '3306';
            $db      = getenv('DB_DATABASE') ?: 'kilopolis_api';
            $usuario = getenv('DB_USER') ?: 'root';
            $clave   = getenv('DB_PASSWORD') ?: '';

            $dsn = "mysql:host=$host;port=$puerto;dbname=$db;charset=utf8mb4";

            $opciones = [
                PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES   => false,
            ];

            try {
                self::$instancia = new PDO($dsn, $usuario, $clave, $opciones);
            } catch (PDOException $e) {
                http_response_code(500);
                header('Content-Type: application/json');
                echo json_encode(['error' => 'Fallo crítico de conexión con la base de datos']);
                exit;
            }
        }

        return self::$instancia;
    }
}

// Ejemplo de consulta preparada segura:
// $db = Database::getConnection();
// $stmt = $db->prepare('SELECT id, nombre, email FROM usuarios WHERE id = :id');
// $stmt->execute(['id' => $usuarioId]);
// $usuario = $stmt->fetch();
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué las consultas preparadas con PDO eliminan por completo el riesgo de Inyección SQL?
🦉
¿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.