Saltar al contenido principal

Instalación y configuración

Para comenzar a trabajar con Laravel, es necesario tener PHP (versión 8 o superior), Composer y un servidor web como Apache o Nginx. Laravel se instala mediante Composer y ofrece herramientas para configurar rápidamente un proyecto funcional.

Creación de un nuevo proyecto​

  1. Instalar Laravel usando Composer:

    composer create-project --prefer-dist laravel/laravel nombre-proyecto

    Esto creará una carpeta nombre-proyecto con toda la estructura inicial de Laravel.

  2. Verificar la instalación:

    cd nombre-proyecto
    php artisan serve

    Accediendo a http://localhost:8000 en el navegador se debería ver la página de bienvenida de Laravel.

Estructura básica del proyecto​

nombre-proyecto/
├─ app/                # Contiene controladores, modelos y lógica de negocio
├─ bootstrap/          # Archivos de arranque y cache
├─ config/             # Archivos de configuración del framework
├─ database/           # Migraciones, seeders y factories
├─ public/             # Punto de entrada de la aplicación (index.php)
├─ resources/          # Vistas, archivos de Blade y assets sin compilar
├─ routes/             # Definición de rutas (web.php, api.php)
├─ storage/            # Archivos generados, logs y cache
├─ tests/              # Pruebas automatizadas
└─ artisan             # CLI de Laravel para ejecutar comandos

Configuración del entorno​

Laravel utiliza un archivo .env para gestionar la configuración sensible y de entorno:

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nombre_base
DB_USERNAME=usuario
DB_PASSWORD=contraseña
  • APP_KEY: Clave de cifrado generada automáticamente con php artisan key:generate.
  • APP_DEBUG: Controla el modo debug de la aplicación.
  • Configuración de base de datos: definir el motor, host, puerto, nombre de la base y credenciales.

Buenas prácticas y convenciones​

  • Mantener el archivo .env fuera del control de versiones (agregar a .gitignore).
  • Usar php artisan key:generate para asegurar la clave de cifrado.
  • Configurar correctamente la conexión a la base de datos antes de ejecutar migraciones.
  • Evitar modificar archivos del núcleo de Laravel; personalizar mediante configuraciones y clases propias.
  • Utilizar artisan serve para desarrollo y un servidor web real para producción.