Instalación y configuración de MariaDB (MySQL) para Laravel

MariaDB es una bifurcación de MySQL totalmente compatible y ampliamente utilizada en proyectos Laravel. A continuación se detallan los pasos necesarios para instalarlo, configurarlo y conectar correctamente tu aplicación Laravel.

1. Instalar MariaDB

Ejecutamos el siguiente comando para instalar tanto el servidor como el cliente de MariaDB:

apt install mariadb-server mariadb-client

Explicación:

  • mariadb-server: el motor de base de datos que se encargará de gestionar la persistencia de datos.
  • mariadb-client: permite conectarnos a la base de datos desde la terminal con el comando mariadb.

2. Verificar estado del servicio

Una vez instalado, comprobamos que el servicio esté en ejecución:

systemctl status mariadb

Debemos ver un mensaje que indique que el servicio está activo (running).

📸 Estado del servicio MariaDB

3. Acceder a MariaDB y crear la base de datos y usuario

Para trabajar con MariaDB, accedemos al cliente desde la terminal:

mariadb -u root

Desde el prompt de SQL ejecutamos:

CREATE DATABASE tutorial;
CREATE USER 'sail'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON tutorial.* TO 'sail'@'%';
FLUSH PRIVILEGES;

Explicación:

  • CREATE DATABASE tutorial;: crea la base de datos donde Laravel guardará sus datos.
  • CREATE USER 'sail'@'%' ...: crea un nuevo usuario llamado sail que podrá conectarse desde cualquier dirección (%).
  • GRANT ALL PRIVILEGES ...: otorga todos los permisos sobre la base de datos tutorial al usuario sail.
  • FLUSH PRIVILEGES;: aplica los cambios inmediatamente.

4. Configuración en Laravel

Ahora toca decirle a Laravel cómo conectarse a esa base de datos. Esto se hace en el archivo .env de tu proyecto:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=tutorial
DB_USERNAME=sail
DB_PASSWORD=password

Ejecutar migraciones

Con todo listo, ahora puedes ejecutar las migraciones de Laravel, que crearán las tablas necesarias en la base de datos:

php artisan migrate --seed

Este comando:

  • Aplica las migraciones en database/migrations/.
  • Inserta datos de prueba si tienes definidos seeders.

Con esto, Laravel ya está conectado a nuestra base de datos MariaDB en un entorno real y listo para gestionar datos.