Tema 8 · Conectividad Backend

Conexión Segura a la Base de Datos desde PHP PDO y Node.js

Aprende a conectar tus aplicaciones backend a MariaDB en Alwaysdata usando PDO en PHP y el conector mysql2 en Node.js siguiendo estándares de seguridad.

phpMyAdmin en la Nube: Importar Tablas y Volcados .sql de Clase Configuración de Sitios Web y Selección de Versiones de PHP (8.2 / 8.3 / 8.4)

Conexión Profesional con PHP Data Objects (PDO)

En el desarrollo backend profesional nunca se utiliza la extensión obsoleta mysql_* ni se concatenan variables en consultas SQL. Se utiliza PDO (PHP Data Objects) con sentencias preparadas (Prepared Statements) para inmunizar la aplicación contra ataques de inyección SQL.

Para conectar tu backend en Alwaysdata, la cadena DSN (Data Source Name) debe apuntar explícitamente al hostname del servidor remoto: 

$dsn = "mysql:host=mysql-tu_cuenta.alwaysdata.net;port=3306;dbname=tu_cuenta_db;charset=utf8mb4";

Atributos Esenciales de PDO para Producción

Atributo PDO Valor Recomendado Propósito
ATTR_ERRMODE ERRMODE_EXCEPTION Lanza excepciones capturables si ocurre un error en la consulta.
ATTR_DEFAULT_FETCH_MODE FETCH_ASSOC Devuelve los resultados como arrays asociativos limpios (clave-valor).
ATTR_EMULATE_PREPARES false Fuerza al motor MariaDB a preparar la consulta de forma nativa.

Conexión Alternativa desde Node.js (Express)

Si tu backend está programado en Node.js, puedes utilizar el paquete oficial mysql2/promise con un grupo de conexiones (Connection Pool): 

import mysql from 'mysql2/promise';

const pool = mysql.createPool({
  host: 'mysql-tu_cuenta.alwaysdata.net',
  user: 'tu_cuenta_app',
  password: process.env.DB_PASSWORD,
  database: 'tu_cuenta_db',
  port: 3306,
  waitForConnections: true,
  connectionLimit: 10
});

⚡ Clase de Conexión PDO Singleton Lista para Usar en Clase

Guarda este archivo en /home/tu_cuenta/app/Database.php para gestionar la base de datos:

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

namespace Kilopolis\App;

use PDO;
use PDOException;

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

    public static function getConnection(): PDO
    {
        if (self::$instance === null) {
            // Sustituye con los datos de tu cuenta en Alwaysdata
            $host     = 'mysql-tu_cuenta.alwaysdata.net';
            $port     = 3306;
            $dbName   = 'tu_cuenta_academia';
            $username = 'tu_cuenta_app';
            $password = 'TuContrasenaSegura2026';

            $dsn = "mysql:host={$host};port={$port};dbname={$dbName};charset=utf8mb4";

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

            try {
                self::$instance = new PDO($dsn, $username, $password, $opciones);
            } catch (PDOException $e) {
                // Registrar el error en el log privado sin exponer la clave en pantalla
                error_log("Error de conexión a MariaDB Alwaysdata: " . $e->getMessage());
                http_response_code(500);
                die(json_encode(["error" => "No se pudo conectar a la base de datos."]));
            }
        }

        return self::$instance;
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué se debe establecer PDO::ATTR_EMULATE_PREPARES en false en una conexión a MariaDB?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual de Alwaysdata: Cloud Hosting & Despliegue Backend 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.

Conocer el Bootcamp

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), 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.