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:
<?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¿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.