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:
- Descargue el instalador: herd.laravel.com
- Ejecute
Herd Installer.exe
→ Siguiente → Instalar - 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:
- Haga clic en el icono de Herd en la bandeja del sistema.
- Asegúrese de que los servicios Nginx y PHP estén activos (indicadores verdes).
- 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(); ?>
. - En Herd, a través de la pestaña de sitios, especifique la ruta a la carpeta test y haga clic en "Add site".
- 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):
4. Instalación de PHP y Composer
Si no usa Herd:
- PHP:
- Descargue PHP 8.3 para Windows
- Descomprima en
C:\PHP
- Añada a PATH:
- Composer:
- Ejecute Composer-Setup.exe
- Verificación:
5. Instalación de PostgreSQL
Para trabajar con bases de datos:
- Descargue PostgreSQL 15
- Ejecute el instalador:
- Contraseña para el superusuario:
admin
(o la suya) - Puerto:
5432
(estándar) - Después de la instalación:
- 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
- Cree una base de datos para el proyecto:
space_api
6. Instalación de Laravel
-
A través de Composer:
-
Inicialización de Git (opcional):
-
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):
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 SGBDcomposer.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
🚀 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ónhttp://localhost:8000
.- En cualquier caso, compruebe que la base de datos
space_api
creada sea visible enpgAdmin 4
.