Cómo crear una base de datos MySQL

schedule 8 min de lectura signal_cellular_alt Principiante

Cada proyecto de nysr.host puede tener una base de datos MySQL. Se crea desde los ajustes del proyecto y el panel muestra el nombre de la base, el usuario y una contraseña generada. La base de datos vive en la misma máquina que tu web, así que el host que usa tu código PHP es siempre localhost.

Esta guía cubre el proceso completo: crear la base, leer las credenciales, conectar desde PHP, comprobar que la conexión funciona de verdad y resolver los errores más habituales.

inventory_2 Qué obtienes

Al crear una base de datos, el panel aprovisiona tres cosas a la vez:

El usuario se crea solo para localhost. Es intencionado: la base de datos no es accesible desde internet, así que nadie puede escanearla ni probar contraseñas desde fuera. Tu PHP se conecta por el socket local, no por la red.

lightbulb

El límite actual es una base de datos por proyecto. Si necesitas una segunda, crea un segundo proyecto. Al renombrar un proyecto también se renombran su base de datos y su usuario.

checklist Antes de empezar

1 settings Abre el panel de ajustes

Ve a tu proyecto en el panel y abre Ajustes y elige Base de datos.

Ajustes, sección Base de datos. Proyecto de ejemplo.
Ajustes, sección Base de datos. Proyecto de ejemplo.

2 storage Crea la base de datos MySQL

Haz clic en la opción para crear una base de datos MySQL. La creación es inmediata: no hay cola de espera ni aprobación manual. El botón queda desactivado cuando ya existe una base, porque un proyecto no puede tener dos.

Si la acción falla, el panel indica el motivo. El más común es que el proyecto ya tenga una base de datos; en ese caso lee las credenciales existentes en lugar de crear otra.

3 key Lee las credenciales

Abre el diálogo de credenciales. Verás cuatro valores, y cada uno tiene su función:

Datos de una base de datos MySQL de ejemplo. La contraseña está oculta.
Datos de una base de datos de ejemplo. La contraseña está oculta.
warning

Si pierdes la contraseña no puedes recuperarla desde la base de datos. El panel puede volver a mostrarla al propietario, pero nunca la pegues en un ticket, una captura o un chat.

4 code Conecta desde PHP

Guarda las credenciales en un único archivo PHP e inclúyelo desde el resto del código. El servidor ejecuta los archivos PHP, así que un visitante no puede descargarlos como texto.

<?php
// config.php — no lo enlaces en público ni lo pegues en capturas
define('DB_HOST', 'localhost');
define('DB_NAME', 'tu_proyecto_db');
define('DB_USER', 'tu_proyecto_user');
define('DB_PASS', 'la-contraseña-generada');

Después conecta con PDO, que es lo que usa la mayoría del código PHP moderno:

require __DIR__ . '/config.php';

$dsn = 'mysql:host=' . DB_HOST . ';dbname=' . DB_NAME . ';charset=utf8mb4';
$pdo = new PDO($dsn, DB_USER, DB_PASS, [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false,
]);

Si tu proyecto usa mysqli, los mismos valores sirven:

$mysqli = new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME);
$mysqli->set_charset('utf8mb4');

if ($mysqli->connect_error) {
    error_log('DB connection failed: ' . $mysqli->connect_error);
    http_response_code(500);
    exit('Database unavailable');
}

La parte charset=utf8mb4 no es opcional si guardas texto de usuarios. Sin ella, los emojis y muchos caracteres no latinos se corrompen o se rechazan sin avisar.

5 science Comprueba la conexión

No des por hecho que funciona porque la página no falló. Crea una tabla, inserta una fila y léela una vez; después borra el código de prueba.

$pdo->exec('CREATE TABLE IF NOT EXISTS connection_test (
    id INT AUTO_INCREMENT PRIMARY KEY,
    note VARCHAR(64) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');

$pdo->prepare('INSERT INTO connection_test (note) VALUES (?)')->execute(['hola']);

$rows = $pdo->query('SELECT note, created_at FROM connection_test')->fetchAll();
echo 'Filas: ' . count($rows);

Si imprime un número de filas, la base, el usuario y la contraseña son correctos. Si lanza una excepción, el mensaje indica el problema exacto; la lista de abajo relaciona cada uno con su solución.

6 lock Mantén las credenciales privadas

No publiques contraseñas de bases de datos en capturas públicas, repositorios públicos ni archivos descargables. Eso incluye archivos .env, .json, .txt, .sql y .md dentro de tu sitio: se sirven como texto plano, así que cualquiera que adivine el nombre puede leerlos.

Un archivo .php es seguro porque PHP lo ejecuta. Un archivo llamado config.php.bak no lo es: el servidor lo entrega como descarga.

build Errores habituales y soluciones

verified Buenas prácticas

Preguntas frecuentes

¿Dónde están las credenciales de la base de datos?

Abre el proyecto en el panel y entra en Ajustes → Base de datos. Ahí aparecen el nombre, el usuario, la contraseña y el host para el propietario del proyecto. Usa esos valores en la conexión PHP y no los publiques.

¿Qué host debo usar en PHP?

localhost. El usuario MySQL se crea solo para el socket local, así que la base no es accesible desde otra máquina. No uses una dirección IP ni un puerto.

¿Puedo conectarme desde MySQL Workbench o desde mi ordenador?

No. Las conexiones remotas están bloqueadas por diseño. Para inspeccionar o exportar datos, ejecuta la consulta desde un script PHP en el sitio, o protege una pequeña página de administración con login antes de usarla.

¿Puedo tener más de una base de datos?

Una base de datos por proyecto. Para tener una segunda, crea un segundo proyecto: recibe su propia base, su usuario y su contraseña, y sus archivos quedan separados.

¿Qué pasa si renombro mi proyecto?

La base de datos y el usuario MySQL se renombran con el nuevo nombre. Si tu PHP tiene el nombre antiguo escrito a mano, actualiza DB_NAME y DB_USER antes de la siguiente petición.

¿Qué pasa si borro la base de datos?

Se elimina de inmediato, junto con su usuario y todas sus tablas. No hay recuperación, así que exporta lo que necesites antes de confirmar.

¿Hay phpMyAdmin?

No. La plataforma no incluye una interfaz gráfica de base de datos. Trabajas con SQL desde PHP, o desde el cliente que ejecutes tú contra una copia de los datos en tu propia máquina.

¿Cómo importo un volcado .sql existente?

Lee el archivo y ejecuta sus sentencias desde un script PHP de un solo uso; después bórralo. Divide el volcado en sentencias individuales si es grande: la plataforma no ofrece una línea de comandos con mysql.

menu_book Guías relacionadas

¿Necesitas una base de datos?

Crea una desde Ajustes → Base de datos en un minuto.

Abrir Panel