Saltar al contenido principal

Instalación y configuración

Para comenzar a trabajar con Lumen, es necesario instalarlo y configurar un proyecto básico. Lumen se distribuye como paquete Composer, por lo que se requiere tener instalado PHP (versión 7.4 o superior) y Composer en el sistema.

Instalación de Lumen​

  1. Crear un nuevo proyecto usando Composer:

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

    Este comando descargará Lumen y todas sus dependencias en la carpeta nombre-del-proyecto.

  2. Acceder al proyecto:

    cd nombre-del-proyecto

  3. Ejecutar el servidor de desarrollo:

    php -S localhost:8000 -t public

    Esto iniciará un servidor local en http://localhost:8000 para probar la aplicación.

Estructura básica del proyecto​

  • app/ → contiene controladores, middleware, modelos y lógica de negocio.
  • bootstrap/ → archivos de arranque y configuración inicial del framework.
  • config/ → configuración de la aplicación (opcional, ya que Lumen minimiza archivos de configuración por defecto).
  • database/ → migraciones, seeds y modelos relacionados con la base de datos.
  • routes/ → define todas las rutas de la aplicación, normalmente en web.php o api.php.
  • public/ → punto de entrada público de la aplicación (index.php, assets).
  • .env → archivo de configuración de entorno (base de datos, claves API, modo debug, etc.).

Configuración inicial​

  • Copiar y configurar el archivo de entorno .env.example como .env.

  • Configurar la conexión a la base de datos:

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=nombre_base
    DB_USERNAME=usuario
    DB_PASSWORD=contraseña

  • Activar los proveedores de servicios que se necesiten en bootstrap/app.php. Por ejemplo, para habilitar Eloquent ORM:

    $app->withEloquent();

Buenas prácticas y convenciones en la configuración​

  • Mantener el archivo .env fuera del control de versiones para proteger credenciales.
  • Activar solo los proveedores de servicios necesarios para mantener la aplicación ligera.
  • Configurar correctamente el modo debug para entornos de desarrollo y desactivarlo en producción.
  • Estructurar las rutas y controladores siguiendo convenciones claras para facilitar el mantenimiento.

Con esta configuración, el proyecto de Lumen queda listo para comenzar a definir rutas, controladores y la lógica de la aplicación.