🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Cómo crear una base de datos MySQL en cPanel y conectar una aplicación PHP

Actualizado el 16 de febrero de 2026

Introducción: La base de todo sitio web dinámico

Si estás leyendo esto, probablemente ya tienes un hosting con cPanel y quieres dar el salto de un sitio estático (HTML/CSS) a uno dinámico con PHP y MySQL. ¡Excelente decisión! MySQL es el motor de bases de datos más popular del mundo, y combinado con PHP forma el dúo perfecto para crear desde blogs hasta tiendas online.

En esta guía completa, paso a paso y sin tecnicismos innecesarios, te voy a enseñar cómo crear una base de datos MySQL en cPanel y, lo más importante, cómo conectar tu aplicación PHP a esa base de datos para que puedas guardar y recuperar información.

No necesitas ser un experto. Solo sigue las instrucciones al pie de la letra y en unos minutos tendrás tu aplicación funcionando. Vamos a ello.

Requisitos previos antes de empezar

Antes de entrar en materia, asegúrate de tener lo siguiente:

  • Acceso a cPanel: Normalmente se accede desde tudominio.com/cpanel o tudominio.com:2083. Si no sabes cómo entrar, contacta con tu proveedor de hosting.
  • Credenciales de acceso: Usuario y contraseña de tu cuenta de hosting.
  • Un editor de texto: Puede ser el Bloc de Notas de Windows, TextEdit en Mac, o algo más avanzado como Visual Studio Code o Sublime Text.
  • Un cliente FTP o el Administrador de Archivos de cPanel: Para subir tus archivos PHP al servidor.

Si tu hosting usa un panel diferente (como Syspanel, que es el nombre que le damos al antiguo HestiaCP y que se accede por el puerto 2106), no te preocupes, el concepto es el mismo, aunque la interfaz varíe un poco. Esta guía se centra en cPanel, que es el más común.

Paso 1: Crear la base de datos MySQL en cPanel

Este es el primer paso. Vamos a crear el "almacén" donde se guardarán los datos de tu aplicación. Es como construir el garaje antes de meter el coche.

  1. Inicia sesión en cPanel con tus credenciales.
  2. Dentro de cPanel, busca la sección "Bases de Datos". Ahí verás varios iconos. Haz clic en "Asistentes de Base de Datos MySQL®". Es la opción más fácil porque te guía por todo el proceso. Alternativamente, puedes usar los iconos individuales "Bases de Datos MySQL" y "Usuarios MySQL", pero el asistente es más intuitivo.

Paso 1.1: Crear la base de datos

  1. En el asistente, verás un campo llamado "Nueva Base de Datos". Escribe un nombre para tu base de datos. cPanel automáticamente le añadirá un prefijo con tu nombre de usuario (por ejemplo, tuusuario_basedatos). No intentes quitar ese prefijo, es una medida de seguridad y es normal.
  2. Haz clic en el botón "Crear Base de Datos".
  3. Verás un mensaje de confirmación. Anota el nombre completo de la base de datos (incluyendo el prefijo). Lo necesitarás más adelante.

Paso 1.2: Crear un usuario para la base de datos

Una base de datos sin usuario es como una caja fuerte sin llave. Necesitas crear un usuario que tenga permiso para acceder a ella.

  1. En el mismo asistente, baja hasta la sección "Crear Usuarios".
  2. Introduce un nombre de usuario (también se le añadirá el prefijo automáticamente) y una contraseña segura. Puedes usar el generador de contraseñas que te ofrece cPanel (el botón "Generador") para crear una contraseña robusta.
  3. Haz clic en "Crear Usuario".

[WARNING] Anota el nombre de usuario y la contraseña en un lugar seguro. No los compartas y guárdalos junto con el nombre de la base de datos. Los necesitarás para conectar tu aplicación PHP.

Paso 1.3: Añadir el usuario a la base de datos

Ahora viene el paso clave: decirle a la base de datos quién puede acceder a ella.

  1. Baja a la sección "Añadir Usuario a la Base de Datos".
  2. En el desplegable de "Usuario", selecciona el usuario que acabas de crear.
  3. En el desplegable de "Base de Datos", selecciona la base de datos que creaste.
  4. Haz clic en "Añadir".
  5. Se abrirá una nueva pantalla con los "Privilegios de Usuario". Para la mayoría de las aplicaciones, la opción más sencilla y segura es marcar la casilla "TODOS LOS PRIVILEGIOS" y hacer clic en "Realizar Cambios". Esto le da al usuario control total sobre esa base de datos específica, que es lo que PHP necesita.

¡Enhorabuena! Ya has creado tu base de datos MySQL y un usuario con acceso. Pero esto no ha terminado. Ahora viene la parte divertida: conectar tu aplicación PHP.

Paso 2: Crear un archivo de conexión PHP

Para conectar PHP y MySQL, utilizaremos la extensión MySQLi (MySQL Improved). Es la forma más moderna y segura de hacerlo. Vamos a crear un archivo PHP que establezca la conexión y nos permita verificar que todo funciona.

  1. Abre tu editor de texto y crea un nuevo archivo. Lo llamaremos conexion.php.
  2. Copia y pega el siguiente código:
<?php
// --- CONFIGURACIÓN DE LA CONEXIÓN ---
// Reemplaza estos valores con los que anotaste anteriormente.

$host = "localhost"; // Generalmente es "localhost" en cPanel
$usuario = "tuusuario_tu_usuario"; // El nombre de usuario con prefijo
$contrasena = "TU_CONTRASEÑA_AQUI"; // La contraseña que elegiste
$base_de_datos = "tuusuario_tu_basededatos"; // El nombre de la base de datos con prefijo

// --- CREAR LA CONEXIÓN ---
// La función mysqli_connect() establece la conexión con el servidor MySQL.
$conexion = mysqli_connect($host, $usuario, $contrasena, $base_de_datos);

// --- VERIFICAR LA CONEXIÓN ---
// Si la conexión falla, mysqli_connect_error() nos dará el motivo.
if (!$conexion) {
    die("Error de conexión: " . mysqli_connect_error());
} else {
    echo "¡Conexión exitosa! Tu PHP y MySQL están conectados correctamente.";
}

// --- CERRAR LA CONEXIÓN (opcional) ---
// Es buena práctica cerrar la conexión cuando ya no se necesita.
mysqli_close($conexion);
?>

[TIP] No te asustes con el código. Es muy sencillo. Las primeras cuatro líneas son variables que contienen tus datos. La función mysqli_connect() hace la magia de la conexión. El resto es solo para comprobar si ha funcionado.

Paso 3: Subir el archivo al servidor

Ahora necesitas que ese archivo PHP esté accesible desde tu servidor web.

  1. Abre el Administrador de Archivos de cPanel (dentro de la sección "Archivos") o tu cliente FTP favorito (como FileZilla).
  2. Navega hasta la carpeta public_html (también puede llamarse htdocs). Esta es la raíz de tu sitio web.
  3. Sube el archivo conexion.php a esa carpeta. Si tienes una aplicación más grande, normalmente la subirías a una subcarpeta, pero para esta prueba, la raíz está bien.

Paso 4: Probar la conexión

Este es el momento de la verdad.

  1. Abre tu navegador web.
  2. Escribe la URL de tu sitio web seguida de /conexion.php. Por ejemplo: https://tudominio.com/conexion.php.
  3. Pulsa Enter.

Si todo ha ido bien, verás el mensaje: "¡Conexión exitosa! Tu PHP y MySQL están conectados correctamente."

[WARNING] Si en lugar de ese mensaje ves un error como "Error de conexión: Access denied for user...", significa que has escrito mal el nombre de usuario o la contraseña en el archivo conexion.php. Revisa los datos y vuelve a subir el archivo. Si ves una página en blanco, puede ser un error de PHP. Asegúrate de que el archivo empieza con <?php y termina con ?>.

Paso 5: Crear una tabla de prueba (opcional pero recomendado)

Conectar es solo el primer paso. Para asegurarte de que tu base de datos funciona correctamente, vamos a crear una tabla de prueba y a insertar un dato. Esto te dará la confianza de que todo el sistema funciona.

  1. Vuelve a cPanel y entra en la sección "phpMyAdmin" (dentro de "Bases de Datos").
  2. En el panel de la izquierda, haz clic en el nombre de tu base de datos.
  3. Verás una interfaz para crear una tabla. Escribe usuarios como nombre de la tabla y 3 como número de columnas. Haz clic en "Crear".
  4. Ahora define las columnas. La primera se llamará id, será de tipo INT, con índice PRIMARY y marcarás la casilla AUTO_INCREMENT. La segunda se llamará nombre, de tipo VARCHAR y longitud 100. La tercera se llamará email, de tipo VARCHAR y longitud 100. Haz clic en "Guardar".
  5. Ahora, en la parte superior de phpMyAdmin, haz clic en la pestaña "Insertar".
  6. En el campo nombre, escribe "Juan Pérez" y en email, escribe "juan@ejemplo.com". El campo id lo dejas vacío (se auto-generará). Haz clic en "Continuar".

¡Listo! Acabas de crear una tabla y guardar un dato. Ahora, modifica tu archivo conexion.php para que consulte esta tabla y muestre los datos. Esto demostrará que puedes leer de la base de datos.

<?php
// ... (la configuración de conexión es la misma que antes) ...

// Consulta SQL: selecciona todos los datos de la tabla usuarios
$consulta = "SELECT * FROM usuarios";

// Ejecutar la consulta
$resultado = mysqli_query($conexion, $consulta);

// Verificar si la consulta tuvo éxito
if (mysqli_num_rows($resultado) > 0) {
    // Mostrar los datos en una lista
    echo "<h2>Usuarios en la base de datos:</h2>";
    echo "<ul>";
    while ($fila = mysqli_fetch_assoc($resultado)) {
        echo "<li>ID: " . $fila["id"] . " - Nombre: " . $fila["nombre"] . " - Email: " . $fila["email"] . "</li>";
    }
    echo "</ul>";
} else {
    echo "No hay usuarios en la tabla.";
}

mysqli_close($conexion);
?>

Sube este archivo reemplazando al anterior y vuelve a cargar tudominio.com/conexion.php. Ahora deberías ver el usuario que insertaste. ¡Felicidades, ya estás programando con bases de datos!

Conclusión y consejos finales

Has aprendido a crear una base de datos cPanel y a conectar PHP MySQL de una manera sencilla y práctica. Este es el fundamento de cualquier aplicación web dinámica.

Recuerda los puntos clave:

  • El prefijo: No lo olvides, es parte del nombre de tu base de datos y usuario. Es una medida de seguridad de los servidores compartidos.
  • La seguridad: Usa contraseñas fuertes y nunca las compartas.
  • La práctica: Empieza con proyectos pequeños y ve aumentando la complejidad.

[INFO] Si tu hosting usa el panel Syspanel (recuerda, el acceso es por el puerto 2106), el proceso es muy similar. Busca la sección de bases de datos MySQL y sigue los mismos pasos. La lógica es universal.

Preguntas frecuentes (FAQ)

  1. ¿Qué es localhost?
    Es el nombre del servidor de bases de datos. En un hosting compartido de cPanel, siempre es localhost, porque la base de datos y el servidor web están en la misma máquina.

  2. ¿Puedo usar MySQLi y PDO?
    Sí, ambos son excelentes. En esta guía hemos usado MySQLi por su simplicidad. PDO (PHP Data Objects) es una alternativa más avanzada que te permite cambiar de motor de base de datos (por ejemplo, a PostgreSQL) sin cambiar el código, pero para empezar MySQLi es perfecto.

  3. ¿Qué hago si veo un error de "headers already sent"?
    Este error suele aparecer si hay espacios en blanco o caracteres extra (como una BOM) antes de <?php o después de ?>. Asegúrate de que tu archivo PHP empiece exactamente con <?php y no tenga nada después del cierre ?> (de hecho, puedes omitir el cierre al final del archivo).

  4. ¿Cómo protejo mi archivo conexion.php?
    Es una buena práctica colocar el archivo de conexión en un directorio fuera de public_html, pero si no es posible, puedes protegerlo con un archivo .htaccess para que no sea accesible públicamente. En el Administrador de Archivos de cPanel, puedes crear un archivo .htaccess dentro de la misma carpeta y añadir: Deny from all. Esto bloqueará el acceso directo a ese archivo desde el navegador.

  5. ¿Y si mi aplicación necesita más de una base de datos?
    Puedes crear tantas bases de datos como te permita tu plan de hosting. El proceso es el mismo.

Con estos conocimientos, ya tienes la base para crear aplicaciones web potentes. ¡Sigue explorando y no dejes de aprender!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel