Laravel

Descripción general

Laravel es un framework de aplicaciones web PHP con una sintaxis expresiva y elegante. Esta guía te acompañará en el despliegue de una aplicación Laravel en la plataforma NStrim de principio a fin.

Inicio rápido

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>

composer install

cp .env.example .env
php artisan key:generate

php artisan migrate
git add .
git commit -m "Initial setup"
git push origin main

Desarrollo local con Docker

Si no tienes PHP instalado localmente, puedes usar Docker para ejecutar comandos de Laravel. El proyecto incluye un Dockerfile que configura todo lo que necesitas.

Requisitos previos

Instala Docker Desktop para tu sistema operativo (Windows, Mac o Linux).

Ejecutar comandos con Docker

En lugar de ejecutar php artisan migrate directamente, lo ejecutas dentro de un contenedor Docker:

# Build the Docker image (only needed once)
docker build -t laravel-app .

# Run any artisan command
docker run --rm laravel-app php artisan migrate

# Run composer install
docker run --rm -v $(pwd):/var/www/html laravel-app composer install

# Interactive shell inside container
docker run --rm -it -v $(pwd):/var/www/html laravel-app bash

Configuración de la base de datos

La plataforma NStrim te proporciona una base de datos MySQL/MariaDB. Necesitas configurar tu archivo .env con las credenciales correctas para conectar.

¿Por qué configurar la base de datos?

Laravel utiliza un archivo .env para guardar la configuración específica del entorno. Por defecto, la plantilla usa SQLite (una base de datos basada en archivos), pero NStrim ofrece MySQL para un mejor rendimiento y compatibilidad con escenarios reales.

Configuración paso a paso

DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=

DB_CONNECTION=mysql
DB_HOST=db.<session-domain>
DB_PORT=3306
DB_DATABASE=<your-username>
DB_USERNAME=<your-username>
DB_PASSWORD=<your-password>

Ejemplo de configuración

Si tu nombre de usuario es student01 y el dominio de la sesión es demo.nstrim.app:

DB_CONNECTION=mysql
DB_HOST=db.demo.nstrim.app
DB_PORT=3306
DB_DATABASE=student01
DB_USERNAME=student01
DB_PASSWORD=your-password-from-dashboard

Ejecutar migraciones

Las migraciones son la forma que tiene Laravel de crear tablas en la base de datos. Tras configurar tu base de datos, ejecuta las migraciones para crear las tablas necesarias:

php artisan migrate

Si necesitas reiniciar y volver a ejecutar todas las migraciones (esto eliminará todos los datos):

php artisan migrate:fresh

Para ejecutar las migraciones con datos de seed (si tu proyecto tiene seeders):

php artisan migrate:fresh --seed

Estructura del proyecto

Entender dónde se ubican los archivos:

├── app/                  # Código de la aplicación
│   ├── Http/
│   │   └── Controllers/  # Aquí van tus controladores
│   └── Models/           # Modelos Eloquent
├── config/               # Archivos de configuración
├── database/
│   ├── migrations/       # Migraciones de la base de datos
│   └── seeders/          # Seeders de la base de datos
├── public/               # Recursos públicos (CSS, JS, imágenes)
├── resources/
│   └── views/            # Plantillas Blade
├── routes/
│   └── web.php           # Rutas web (URL → Controlador)
├── .env                  # Configuración del entorno (BD, etc.)
└── composer.json         # Dependencias PHP
        

Tareas comunes

Crear un nuevo controlador

php artisan make:controller ProductController

Crear un nuevo modelo con migración

php artisan make:model Product -m

Añadir una ruta

Edita routes/web.php:

Route::get('/products', [ProductController::class, 'index']);

Limpiar la caché

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Comandos útiles

Resolución de problemas

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Comprobar tu base de datos

Puedes acceder a phpMyAdmin para gestionar visualmente tu base de datos. Haz clic en el botón MySQL de tu panel para abrir phpMyAdmin. Inicia sesión con las mismas credenciales que se muestran en tu panel.

Desde phpMyAdmin puedes:

• Ver todas las tablas creadas por las migraciones
• Navegar y editar datos directamente
• Ejecutar consultas SQL personalizadas
• Exportar/importar datos de la base de datos

Flujo de despliegue

Cada vez que haces push de tu código a Git, tu aplicación se despliega automáticamente:

La URL de tu aplicación desplegada sigue este formato:

https://<your-subdomain>-<repo-name>.<session-domain>

Ejemplo: https://student01-module-a.demo.nstrim.app