Skip to content

Capítulo 2.1: Preparación del entorno de Laravel

Tiempo de estudio: 1-2 horas

1. ¿Por qué se necesita un entorno local?

Imagine que está construyendo una sonda espacial. Antes de lanzarla al espacio, prueba todos los sistemas en la Tierra. Un entorno local es su "laboratorio de control" para el código:

  • Experimentos seguros sin afectar al servidor de producción
  • Despliegue rápido de dependencias
  • Fácil cambio entre versiones de software

💡 Analogía espacial: Herd = Complejo de lanzamiento móvil Docker = Simulador de estación espacial XAMPP = Banco de pruebas estacionario


2. Instalación de Herd

Herd — una herramienta moderna para la gestión del entorno PHP (análogo a Laravel Valet).

Pasos de instalación:

  1. Descargue el instalador: herd.laravel.com
  2. Ejecute Herd Installer.exe → Siguiente → Instalar
  3. Después de la instalación:
    • Abra Herd desde el menú Inicio. El icono de la aplicación aparecerá en la bandeja del sistema (junto al reloj).
    • Haga clic en el icono de Herd: asegúrese de que Nginx y la versión de PHP necesaria (por ejemplo, 8.3) estén en ejecución (marcados con un punto verde).
    • Vaya a Herd Paths y añada la carpeta donde se almacenarán sus proyectos (por ejemplo, C:\Users\SuUsuario\Code). Herd creará automáticamente un dominio atractivo para cada subdirectorio en esta carpeta, del tipo nombre-de-carpeta.test.

⚠️ ¡Importante! Durante la instalación: - Permita el acceso a la red (si el firewall lo solicita) - Verifique la ruta en PATH: C:\Program Files\Herd\bin

Verificación de funcionamiento:

  1. Haga clic en el icono de Herd en la bandeja del sistema.
  2. Asegúrese de que los servicios Nginx y PHP estén activos (indicadores verdes).
  3. Cree en su carpeta de proyectos (por ejemplo, C:\Users\SuUsuario\Code) una carpeta llamada test, y dentro de ella un archivo index.php con el contenido <?php phpinfo(); ?>.
  4. En Herd, a través de la pestaña de sitios, especifique la ruta a la carpeta test y haga clic en "Add site".
  5. Abra en el navegador la dirección http://test.test. Debería ver una página con información sobre PHP.

3. Métodos alternativos (brevemente)

Herramienta Para quién Pros Contras
Laravel Sail (Docker) Para todos los niveles Aislamiento completo, repetibilidad del entorno, soporte oficial de Laravel Requiere instalación de Docker, consume más recursos
XAMPP Principiantes Todo en un instalador (All-in-One) Voluminoso, más difícil de gestionar versiones de software, ensucia el sistema
Laragon Desarrolladores de Windows Rápido, fácil de cambiar versiones, configuración automática de hosts Requiere reinicio manual del servidor web al añadir un nuevo proyecto

Ejemplo con Docker (Laravel Sail):

# Después de instalar Docker
./vendor/bin/sail up


4. Instalación de PHP y Composer

Si no usa Herd:

  1. PHP:
    • Descargue PHP 8.3 para Windows
    • Descomprima en C:\PHP
    • Añada a PATH:
      # Se recomienda ejecutar en PowerShell como administrador
      [Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\PHP", "User")
      
  2. Composer:

5. Instalación de PostgreSQL

Para trabajar con bases de datos:

  1. Descargue PostgreSQL 15
  2. Ejecute el instalador:
  3. Contraseña para el superusuario: admin (o la suya)
  4. Puerto: 5432 (estándar)
  5. Después de la instalación:
  6. Abra pgAdmin 4 (cliente gráfico)

    Puede utilizar cualquier otro cliente para trabajar con la base de datos, por ejemplo, DBeaver, DataGrip o incluso la línea de comandos. Yo prefiero DBeaver - pero es cuestión de gustos

  7. Cree una base de datos para el proyecto: space_api

6. Instalación de Laravel

  1. A través de Composer:

    composer create-project laravel/laravel space-api
    cd space-api
    

  2. Inicialización de Git (opcional):

    git init
    git add .
    git commit -m "Inicio del proyecto espacial"
    

  3. Inicio y verificación del servidor:

    Si utiliza Herd: Asegúrese de que su proyecto space-api se encuentre en la carpeta que añadió a Herd. Abra en el navegador la dirección: http://space-api.test Debería ver la página de inicio de Laravel. ¡El servidor ya está funcionando gracias a Herd!

Si NO utiliza Herd (instalación manual):

php artisan serve
Abra en el navegador: http://localhost:8000 → ¡Debería aparecer la página de inicio de Laravel!

Al crear un proyecto en Herd:

Simplemente siga las instrucciones en pantalla. Para mayor comodidad, el nombre del proyecto será space-api. El kit de inicio puede ser cualquiera, pero yo prefiero React.

Asegúrese de incluir phpunit - nos será útil más adelante

7. Configuración del proyecto

Archivos importantes:

  • .env — configuración del entorno (claves, bases de datos)
  • config/database.php — configuración de la SGBD
  • composer.json — dependencias de PHP

Conexión de la BD al proyecto:

Añada a .env:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=space_api
DB_USERNAME=postgres # Usuario para postgres
DB_PASSWORD=admin # Contraseña para postgres

Primeros comandos Artisan:

php artisan key:generate  # Generación de la clave de la aplicación
php artisan migrate:fresh # Migración de la base de datos (al cambiar a postgres)


Cuestionario de repaso

1. Herd es...

2. ¿Qué herramienta utiliza Laravel para gestionar las dependencias de PHP?

3. Puerto estándar para PostgreSQL:

4. Comando para crear un proyecto Laravel a través de Composer:

5. ¿Archivo con la configuración del entorno?


🚀 Conclusión del Capítulo

¡Ha desplegado la "plataforma de lanzamiento" para la API espacial! Ahora tiene:

  • 🛠️ Entorno local (Herd o instalación manual) con PHP y Nginx
  • 🐘 Servidor de base de datos PostgreSQL instalado
  • 🚀 Proyecto Laravel space-api
  • 🔌 Conexión a la base de datos configurada

📌 Verificación:

  • Si usa Herd: Asegúrese de que el sitio web se abra en la dirección http://space-api.test.
  • Si no usa Herd: Asegúrese de que el comando php artisan serve funcione y que el sitio web se abra en la dirección http://localhost:8000.
  • En cualquier caso, compruebe que la base de datos space_api creada sea visible en pgAdmin 4.