Centro de Ayuda

PHP + Laravel + MariaDB

Laravel es el framework PHP más usado para aplicaciones a medida: ORM Eloquent, migraciones, sistema de colas, autenticación y un motor de plantillas propio, todo con una sintaxis muy cuidada.

Este Stack lo combina con MariaDB.

Servicios que incluye

Además de tu aplicación, el Stack levanta MariaDB, un nginx que recibe el tráfico del puerto 80, un servicio de backups automáticos y el administrador de archivos web.

Estructura del proyecto

text
.
├── app
│   ├── app
│   │   └── ...
│   ├── bootstrap
│   │   ├── app.php
│   │   └── providers.php
│   ├── config
│   │   ├── app.php
│   │   └── database.php
│   ├── public
│   │   └── index.php
│   ├── routes
│   │   ├── console.php
│   │   └── web.php
│   ├── artisan
│   └── composer.json
├── backup
│   └── backup-runner.sh
├── nginx
│   └── default.conf
├── .env.example
├── app.Dockerfile
└── compose.yaml

Puesta en marcha

Instalá el Stack y levantalo:

bash
docker-deploy-stack --stack php/laravel-mariadb
cd /root/stack/php/laravel-mariadb
docker compose up -d

Después reemplazá la aplicación de ejemplo por la tuya, desde Git, por SFTP o desde el administrador de archivos web, siguiendo como-despliego-una-aplicacion-en-un-stack.md. Tu código va en la carpeta app/.

Cada vez que actualices el código, aplicá los cambios:

bash
docker compose up -d --build

Configuración

Los valores editables están en el archivo .env del Stack:

Variable Por defecto Para qué sirve
APP_PORT 80 Puerto público del Stack.
APP_ENV development Entorno de la aplicación.
DB_NAME laravel Nombre de la base de datos.
DB_USER laravel Usuario de la base de datos.
BACKUP_ENABLED 1 Backups automáticos: 1 activados, 0 desactivados.
BACKUP_INTERVAL_SECONDS 86400 Cada cuántos segundos se hace un backup.
BACKUP_RETENTION_DAYS 7 Cuántos días se conservan los backups.
MARIADB_VERSION 11.4 Versión de la imagen correspondiente.

Después de cambiarlo, aplicá los cambios con docker compose up -d.

Comandos útiles

bash
docker compose ps          # ver los contenedores que están corriendo
docker compose logs -f     # ver los logs en vivo
docker compose restart     # reiniciar los servicios
docker compose down        # detener y eliminar los contenedores