2. Instalación y Configuración de Laravel

Instalación y Configuración de Laravel

Instalar Laravel vía Composer

Composer es el gestor de dependencias para PHP que Laravel utiliza para manejar sus paquetes y dependencias. Antes de instalar Laravel, asegúrate de tener instalado:

• PHP >= 8.1
• Composer
• Las extensiones de PHP requeridas (mencionadas en la sección de Introducción)

Instalación global de Laravel Installer

La forma más rápida de comenzar con Laravel es utilizando el instalador global de Laravel:

composer global require laravel/installer

Una vez instalado, puedes crear un nuevo proyecto Laravel con el comando laravel new:

laravel new mi-proyecto

Tip

Asegúrate de que el directorio ~/.composer/vendor/bin (o el equivalente en tu sistema) esté en tu variable de entorno PATH para poder ejecutar el comando laravel.

Instalación vía Composer create-project

Alternativamente, puedes crear un proyecto Laravel utilizando directamente Composer:

composer create-project laravel/laravel mi-proyecto

Instalación de una versión específica

Si necesitas instalar una versión específica de Laravel, puedes especificarla así:

composer create-project laravel/laravel mi-proyecto 10.*

Windows

# Navegar al directorio del proyecto
cd mi-proyecto

# Verificar la instalación
php artisan --version

macOS/Linux

# Navegar al directorio del proyecto
cd mi-proyecto

# Verificar la instalación
php artisan --version

Configurar .env

Laravel utiliza un archivo .env para gestionar la configuración del entorno. Cuando instalas Laravel, se crea automáticamente un archivo .env.example que debes copiar a .env:

cp .env.example .env

A continuación, genera una clave de aplicación:

php artisan key:generate

Configuración básica del archivo .env

El archivo .env contiene variables de entorno cruciales para tu aplicación. Aquí están las más importantes que debes configurar:

# Entorno de la aplicación
APP_NAME=Laravel
APP_ENV=local # local, production, testing, staging
APP_KEY=base64:tu-clave-generada
APP_DEBUG=true # true para desarrollo, false para producción
APP_URL=http://localhost

# Configuración de la base de datos
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

# Configuración de correo
MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="APP_NAME"

Caution

Nunca incluyas el archivo .env en el control de versiones. Contiene información sensible como claves de API, contraseñas y credenciales.

Acceder a variables de entorno en el código

Para acceder a las variables de entorno en tu código Laravel, puedes utilizar la función helper

env()

. Esta función acepta dos parámetros:

1. El nombre de la variable de entorno que deseas obtener
2. Un valor predeterminado (opcional) que se devolverá si la variable no existe

Ejemplo de uso:

$databaseName = env('DB_DATABASE', 'laravel');

Sin embargo, es recomendable utilizar el helper

config()

para acceder a valores de configuración, ya que estos valores se almacenan en caché durante las solicitudes, mejorando el rendimiento:

$appName = config('app.name');

Tip

La función

env()

solo debe utilizarse en archivos de configuración. En el código de la aplicación, siempre usa

config()

para evitar problemas de rendimiento.

Estructura básica de carpetas

Laravel tiene una estructura de carpetas bien organizada. Aquí están los directorios principales y su propósito:

Directorios principales

Directorio	Descripción
app/	Contiene el código principal de la aplicación
bootstrap/	Contiene archivos de inicio y caché
config/	Contiene todos los archivos de configuración
database/	Contiene migraciones, factories y seeders
public/	El punto de entrada de la aplicación y assets públicos
resources/	Contiene vistas, assets sin compilar y traducciones
routes/	Contiene todas las definiciones de rutas
storage/	Contiene logs, caché compilado y archivos generados
tests/	Contiene pruebas automatizadas
vendor/	Contiene dependencias de Composer (no editar)

Directorio app/

Subdirectorio	Descripción
app/Console/	Comandos Artisan personalizados
app/Exceptions/	Manejadores de excepciones
app/Http/	Controladores, middleware y requests
app/Models/	Modelos Eloquent
app/Providers/	Proveedores de servicios

Archivos importantes

• .env

  : Configuración del entorno

• composer.json

  : Dependencias y configuración de Composer

• package.json

  : Dependencias de Node.js para frontend

• artisan

  : CLI de Laravel

• webpack.mix.js

  o

  vite.config.js

  : Configuración de compilación de assets

Servidor local con Artisan

Laravel incluye un servidor de desarrollo integrado a través de Artisan, que es perfecto para el desarrollo local.

Iniciar el servidor

Para iniciar el servidor de desarrollo:

php artisan serve

Por defecto, el servidor se ejecuta en

http://localhost:8000

.

Personalizar host y puerto

Puedes personalizar el host y el puerto:

php artisan serve --host=0.0.0.0 --port=8080

Artisan Tinker

Laravel incluye Tinker, una REPL (Read-Eval-Print Loop) que te permite interactuar con tu aplicación desde la línea de comandos:

php artisan tinker

Ejemplo de uso:

>>> AppModelsUser::count();
=> 5
>>> $user = AppModelsUser::find(1);
=> AppModelsUser {...}
>>> $user->email;
=> "admin@example.com"

Comandos Artisan comunes

# Listar todos los comandos disponibles
php artisan list

# Crear un controlador
php artisan make:controller UserController

# Crear un modelo con migración
php artisan make:model Product -m

# Ejecutar migraciones
php artisan migrate

# Limpiar caché
php artisan cache:clear

# Optimizar la aplicación para producción
php artisan optimize

Configuración de idiomas y zona horaria

Laravel proporciona herramientas para internacionalizar tu aplicación y manejar zonas horarias.

Configuración de idioma

El idioma predeterminado se configura en

config/app.php

:

'locale' => 'es',
'fallback_locale' => 'en',

Archivos de traducción

Los archivos de traducción se almacenan en

resources/lang/{idioma}/

.

Para crear un nuevo archivo de traducción:

1. Crea la carpeta del idioma si no existe:

   resources/lang/es/

2. Crea un archivo PHP con las traducciones:

resources/lang/es/messages.php

<?php
return [
'welcome' => 'Bienvenido a nuestra aplicación',
'goodbye' => 'Hasta pronto',
];

Uso de traducciones

Puedes usar el helper __() para traducir textos:

echo __('messages.welcome');
// Muestra: Bienvenido a nuestra aplicación

O en Blade:

{{ __('messages.welcome') }}

Cambiar el idioma en tiempo de ejecución

// Cambiar el idioma actual
App::setLocale('es');

// Verificar el idioma actual
if (App::isLocale('es')) {
// Código específico para español
}

Configuración de zona horaria

La zona horaria predeterminada se configura en

config/app.php

:

'timezone' => 'America/Mexico_City',

Tip

Puedes encontrar una lista de zonas horarias válidas en la documentación de PHP.

Trabajar con fechas

Laravel utiliza Carbon para manejar fechas, que es una extensión de la clase DateTime de PHP:

use CarbonCarbon;

// Fecha actual en la zona horaria de la aplicación
$now = Carbon::now();

// Formatear fecha
echo $now->format('Y-m-d H:i:s');

// Fecha localizada
echo $now->locale('es')->isoFormat('LLLL');
// Ejemplo: "domingo, 15 de junio de 2025 23:34"

Próximos pasos

Ahora que tienes Laravel instalado y configurado, puedes comenzar a desarrollar tu aplicación. Los siguientes pasos podrían ser:

1. Configurar la base de datos y crear migraciones
2. Definir rutas y controladores
3. Crear modelos Eloquent
4. Diseñar vistas con Blade

Note

Recuerda consultar la documentación oficial de Laravel para obtener información más detallada sobre cada tema.