Skip to main content
Las variables de entorno se definen en el archivo .env en la raíz del proyecto. El archivo .env.example incluye todas las variables requeridas con valores de ejemplo.
Nunca publiques el archivo .env en control de versiones. Contiene credenciales de base de datos, claves de aplicación y contraseñas de servicios externos. Asegúrate de que .env esté listado en .gitignore.

Aplicación

APP_NAME
string
default:"Laravel"
Nombre de la aplicación. Se usa en correos y en el pie de página del panel de administración.
APP_ENV
string
default:"local"
Entorno de ejecución. Valores comunes: local, staging, production. Afecta comportamientos de caché, depuración y optimización.
APP_KEY
string
required
Clave secreta de cifrado de la aplicación. Genera una con php artisan key:generate. Sin este valor la aplicación no arrancará.
APP_DEBUG
boolean
default:"true"
Activa o desactiva el modo depuración. En producción debe ser false para evitar exponer trazas de error al usuario final.
APP_URL
string
default:"http://localhost"
URL base de la aplicación. Se usa para generar enlaces en correos y en la generación de recursos.

Base de datos

DB_CONNECTION
string
default:"mysql"
Driver de base de datos. El proyecto usa mysql.
DB_HOST
string
default:"127.0.0.1"
Host del servidor de base de datos.
DB_PORT
number
default:"3306"
Puerto de conexión a la base de datos.
DB_DATABASE
string
default:"proyecto_base"
Nombre de la base de datos.
DB_USERNAME
string
default:"root"
Usuario de la base de datos.
DB_PASSWORD
string
Contraseña del usuario de la base de datos.

Correo electrónico

MAIL_MAILER
string
default:"smtp"
Driver de correo. Valores comunes: smtp, sendmail, log, array.
MAIL_HOST
string
default:"mailhog"
Host del servidor SMTP. En desarrollo local se puede usar mailhog o mailtrap.io.
MAIL_PORT
number
default:"1025"
Puerto del servidor SMTP. Valores comunes: 587 (TLS), 465 (SSL), 1025 (Mailhog local).
MAIL_USERNAME
string
Usuario de autenticación SMTP.
MAIL_PASSWORD
string
Contraseña de autenticación SMTP.
MAIL_ENCRYPTION
string
Tipo de cifrado para la conexión SMTP. Valores: tls, ssl, o null para sin cifrado.
MAIL_FROM_ADDRESS
string
Dirección de correo remitente para los mensajes enviados por la aplicación.
MAIL_FROM_NAME
string
default:"${APP_NAME}"
Nombre del remitente para los correos enviados. Por defecto toma el valor de APP_NAME.

Caché, sesiones y colas

CACHE_DRIVER
string
default:"file"
Driver de caché. Valores comunes: file, redis, database, array.
SESSION_DRIVER
string
default:"file"
Driver de sesiones. Valores comunes: file, cookie, database, redis.
SESSION_LIFETIME
number
default:"120"
Tiempo de vida de la sesión en minutos.
QUEUE_CONNECTION
string
default:"sync"
Driver de colas. En desarrollo se usa sync (ejecución inmediata). En producción se recomienda database o redis.
BROADCAST_DRIVER
string
default:"log"
Driver de broadcasting para eventos en tiempo real.

Almacenamiento

FILESYSTEM_DRIVER
string
default:"local"
Driver del sistema de archivos. Valores: local, public, s3.

Redis

REDIS_HOST
string
default:"127.0.0.1"
Host del servidor Redis. Requerido si CACHE_DRIVER o SESSION_DRIVER usan redis.
REDIS_PASSWORD
string
default:"null"
Contraseña del servidor Redis (null si no tiene contraseña).
REDIS_PORT
number
default:"6379"
Puerto del servidor Redis.

Logging

LOG_CHANNEL
string
default:"stack"
Canal de logging. El canal stack agrupa múltiples canales definidos en config/logging.php.
LOG_LEVEL
string
default:"debug"
Nivel mínimo de log. Valores en orden ascendente: debug, info, notice, warning, error, critical, alert, emergency.

AWS S3 (opcional)

Requerido únicamente si FILESYSTEM_DRIVER=s3.
AWS_ACCESS_KEY_ID
string
ID de clave de acceso de AWS.
AWS_SECRET_ACCESS_KEY
string
Clave de acceso secreta de AWS.
AWS_DEFAULT_REGION
string
default:"us-east-1"
Región de AWS donde está el bucket.
AWS_BUCKET
string
Nombre del bucket S3.
AWS_USE_PATH_STYLE_ENDPOINT
boolean
default:"false"
Activa el estilo de endpoint por ruta. Requerido para compatibilidad con MinIO u otros servicios S3-compatibles.

Build docs developers (and LLMs) love