Instalación del entorno de desarrollo

Requisitos previos

Laravel 12 requiere PHP 8.4 o superior con las siguientes extensiones habilitadas:

• BCMath
• Ctype
• Fileinfo
• JSON
• Mbstring
• OpenSSL
• PDO
• Tokenizer
• XML

No te preocupes si esta lista parece larga. La mayoría de estas extensiones vienen habilitadas por defecto en las instalaciones modernas de PHP.

¿Qué es Composer?

Composer es el gestor de dependencias de PHP. Funciona de manera similar a npm en JavaScript o pip en Python. Con Composer puedes:

• Instalar paquetes y librerías de terceros
• Gestionar las versiones de tus dependencias
• Autocargar clases automáticamente

Laravel se instala a través de Composer, por lo que es un requisito obligatorio.

Opciones de entorno de desarrollo

Tienes tres opciones principales para configurar tu entorno de desarrollo con Laravel:

• Laravel Sail - Entorno Docker (recomendado)
• Laravel Herd - Aplicación nativa para macOS/Windows
• Servidor integrado de PHP - Instalación manual tradicional

Cada opción tiene sus ventajas. A continuación te explicamos cómo configurar cada una.

Opción 1: Laravel Sail (recomendado)

Laravel Sail es la opción oficial y recomendada por el equipo de Laravel. Utiliza Docker para crear un entorno de desarrollo completo que incluye PHP, MySQL, Redis y más.

Ventajas de Sail

• No necesitas instalar PHP ni MySQL en tu sistema
• Entorno idéntico para todos los miembros del equipo
• Fácil de configurar servicios adicionales (Redis, Mailpit, etc.)
• Funciona en Windows, macOS y Linux

Requisitos para Sail

Necesitas tener Docker Desktop instalado:

• Windows: Docker Desktop con WSL2
• macOS: Docker Desktop
• Linux: Docker Engine y Docker Compose

Instalar Docker Desktop

Descarga e instala Docker Desktop desde docker.com según tu sistema operativo. Una vez instalado, verifica que funciona:

# Verificar que Docker está instalado
docker --version
docker compose version

Si ambos comandos muestran una versión, Docker está listo. En la próxima lección crearemos un proyecto con Sail.

Opción 2: Laravel Herd

Laravel Herd es una aplicación nativa que instala PHP, Nginx y otras herramientas necesarias con un solo clic. Es muy rápido y consume pocos recursos.

Ventajas de Herd

• Instalación en menos de un minuto
• Muy ligero (no usa Docker)
• Cambio rápido entre versiones de PHP
• Incluye herramientas útiles (Expose, DBngin)

Instalar Herd

Herd está disponible para macOS y Windows. Descárgalo desde herd.laravel.com.

Una vez instalado, Herd configura automáticamente PHP y Composer en tu sistema. Puedes verificarlo:

php --version
composer --version

Opción 3: Servidor integrado de PHP

Si prefieres una instalación tradicional, puedes instalar PHP y Composer manualmente en tu sistema.

Instalar PHP en Windows

La forma más sencilla es usar un paquete como XAMPP o Laragon. Laragon es especialmente recomendado para Laravel:

1. Descarga Laragon desde laragon.org
2. Instala con las opciones por defecto
3. Laragon incluye PHP, MySQL, Composer y más

Instalar PHP en macOS

La forma recomendada es usar Homebrew:

# Instalar Homebrew (si no lo tienes)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar PHP
brew install php

Instalar PHP en Linux (Ubuntu/Debian)

# Añadir repositorio de PHP
sudo add-apt-repository ppa:ondrej/php
sudo apt update

# Instalar PHP 8.4 con extensiones necesarias
sudo apt install php8.4 php8.4-cli php8.4-mbstring php8.4-xml php8.4-curl php8.4-zip php8.4-mysql

Instalar Composer

Una vez que tengas PHP instalado, instala Composer siguiendo las instrucciones oficiales:

# Descargar el instalador
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# Ejecutar el instalador
php composer-setup.php

# Mover a un directorio del PATH (Linux/macOS)
sudo mv composer.phar /usr/local/bin/composer

# Verificar instalación
composer --version

¿Cuál elegir?

La elección depende de tu situación:

• Laravel Sail: Si trabajas en equipo o quieres un entorno reproducible. Ideal para proyectos que necesitan MySQL, Redis u otros servicios.
• Laravel Herd: Si usas macOS o Windows y prefieres algo ligero y rápido. Perfecto para desarrolladores individuales.
• Servidor integrado: Si ya tienes PHP instalado o usas Linux. Mayor control pero más configuración manual.

Verificar tu instalación

Independientemente de la opción que elijas, verifica que todo esté funcionando correctamente:

# Verificar versión de PHP (debe ser 8.4 o superior)
php --version

# Verificar extensiones de PHP
php -m | grep -E 'mbstring|xml|curl|zip'

# Verificar Composer
composer --version

# Para Sail, verificar Docker
docker --version
docker compose version

Ejercicios

Ejercicio 1: Preparar el entorno

Elige una de las tres opciones de instalación y configura tu entorno de desarrollo. Verifica que PHP y Composer estén correctamente instalados ejecutando los comandos de verificación.

Ejercicio 2: Explorar las extensiones

Ejecuta php -m en tu terminal para ver todas las extensiones de PHP instaladas. Identifica cuáles de las extensiones requeridas por Laravel tienes habilitadas.

Ejercicio 3: Investigar Docker (opcional)

Si elegiste Laravel Sail, ejecuta docker ps para ver los contenedores en ejecución. Investiga qué hace cada uno de los contenedores que Sail crea por defecto.