Conexión a Base de Datos con PHP (PDO)

PDO (PHP Data Objects) es la forma recomendada de conectarse a bases de datos en PHP. Ofrece una interfaz consistente para distintos motores (MySQL/MariaDB, PostgreSQL, SQLite, etc.), soporte de prepared statements y manejo de errores robusto.

Índice

• DSN (cadena de conexión) por motor
• Conexión a MySQL/MariaDB
• Conexión a PostgreSQL
• Conexión a SQLite
• Probar la conexión con una consulta
• Manejo de errores (try/catch)
• Buenas prácticas
• Problemas comunes

DSN (cadena de conexión) por motor

Conexión a MySQL/MariaDB (PDO)

<?php
declare(strict_types=1);

$dsn  = 'mysql:host=localhost;dbname=miapp;charset=utf8mb4';
$user = 'usuario_app';
$pass = 'secreto';

try {
  $pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,  // Excepciones en errores
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,        // fetch como array asociativo
    PDO::ATTR_EMULATE_PREPARES   => false,                   // prepared reales
  ]);

  echo "✅ Conectado a MySQL/MariaDB";
} catch (PDOException $e) {
  // No exponer credenciales ni DSN en producción
  echo "❌ Error de conexión: " . $e->getMessage();
}
?>

Conexión a PostgreSQL (PDO)

<?php
$dsn  = 'pgsql:host=localhost;port=5432;dbname=miapp';
$user = 'usuario_app';
$pass = 'secreto';

try {
  $pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
  ]);
  // Charset (opcional): $pdo->exec("SET NAMES 'UTF8'");
  echo "✅ Conectado a PostgreSQL";
} catch (PDOException $e) {
  echo "❌ Error de conexión: " . $e->getMessage();
}
?>

Conexión a SQLite (PDO)

<?php
$dsn = 'sqlite:' . __DIR__ . '/data/miapp.sqlite';

try {
  $pdo = new PDO($dsn, null, null, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
  ]);
  echo "✅ Conectado a SQLite";
} catch (PDOException $e) {
  echo "❌ Error de conexión: " . $e->getMessage();
}
?>

Probar la conexión con una consulta

Ejemplo de SELECT con prepared statement (seguro contra inyección SQL):

<?php
// Suponiendo $pdo conectado
$stmt = $pdo->prepare('SELECT id, nombre, email FROM usuarios WHERE id = :id');
$stmt->execute([':id' => 1]);
$usuario = $stmt->fetch();

if ($usuario) {
  echo "Usuario: " . $usuario['nombre'] . " (" . $usuario['email'] . ")";
} else {
  echo "No se encontró el usuario";
}
?>

Manejo de errores (try/catch)

Siempre usá try/catch y PDO::ERRMODE_EXCEPTION para capturar errores correctamente.

<?php
try {
  $pdo->beginTransaction();

  $stmt = $pdo->prepare('INSERT INTO usuarios (nombre, email) VALUES (:n, :e)');
  $stmt->execute([':n' => 'Pablo', ':e' => 'pablo@mail.com']);

  $pdo->commit();
  echo "✅ Insert ok";
} catch (Throwable $ex) {
  $pdo->rollBack();
  // Log real: error_log($ex->getMessage());
  echo "❌ Ocurrió un error. Intente de nuevo.";
}
?>

Buenas prácticas

• PDO + prepared statements (nunca concatenes variables en SQL).
• UTF-8/utf8mb4 para texto (evita problemas de caracteres).
• Credenciales en variables de entorno o configuraciones fuera del repositorio (no en el código).
• Usuario de BD con mínimos privilegios (no root para la app).
• Manejo de errores con excepciones y logs; no mostrar detalles sensibles al usuario.
• Transacciones para operaciones múltiples que deben ser atómicas.

Problemas comunes