Crear tu primer proyecto Laravel

Formas de crear un proyecto

Existen dos formas principales de crear un proyecto Laravel:

• Instalador de Laravel - Más rápido y con opciones interactivas
• Composer create-project - Método tradicional, funciona siempre

Ambos métodos producen el mismo resultado. La diferencia está en la experiencia de instalación.

Método 1: Instalador de Laravel

El instalador oficial de Laravel ofrece una experiencia interactiva que te permite configurar tu proyecto paso a paso.

Instalar el instalador

Primero, instala el instalador de Laravel de forma global con Composer:

composer global require laravel/installer

Crear el proyecto

Ahora puedes crear proyectos con el comando laravel new:

laravel new mi-proyecto

El instalador te hará varias preguntas:

• Starter kit - Elige "No starter kit" para empezar desde cero
• Testing framework - Elige Pest o PHPUnit (ambos funcionan bien)
• Base de datos - SQLite es perfecto para empezar
• Migraciones - Responde "yes" para crear las tablas iniciales

Método 2: Composer create-project

Si prefieres no instalar el instalador global, puedes usar Composer directamente:

composer create-project laravel/laravel mi-proyecto

Este comando descarga Laravel y crea el proyecto con la configuración por defecto.

Crear proyecto con Laravel Sail

Si elegiste Laravel Sail en la lección anterior, el proceso es ligeramente diferente. Laravel proporciona un script que configura todo automáticamente:

# En macOS/Linux
curl -s "https://laravel.build/mi-proyecto" | bash

# En Windows (PowerShell)
curl -s "https://laravel.build/mi-proyecto" | bash

Este comando crea el proyecto y configura Docker automáticamente. Una vez terminado, entra en la carpeta y arranca Sail:

cd mi-proyecto
./vendor/bin/sail up

Arrancar el servidor de desarrollo

Una vez creado el proyecto, entra en la carpeta y arranca el servidor de desarrollo. Para ello usarás Artisan, la herramienta de línea de comandos que viene con Laravel.

Artisan te permite ejecutar tareas comunes como arrancar un servidor, crear archivos, ejecutar migraciones y mucho más. Lo usarás constantemente durante el desarrollo.

cd mi-proyecto
php artisan serve

Verás un mensaje indicando que el servidor está corriendo:

INFO  Server running on [http://127.0.0.1:8000]

Press Ctrl+C to stop the server

Abre tu navegador y visita http://127.0.0.1:8000 (o http://localhost:8000). Verás la página de bienvenida de Laravel.

Configuración inicial

Laravel genera un archivo .env con la configuración de tu aplicación. Este archivo contiene variables de entorno como:

• APP_NAME - Nombre de tu aplicación
• APP_ENV - Entorno (local, production)
• APP_DEBUG - Mostrar errores detallados
• APP_URL - URL base de la aplicación
• DB_* - Configuración de base de datos

Por ahora, la configuración por defecto es suficiente. Exploraremos estas opciones en lecciones posteriores.

Comandos Artisan útiles

Todos los comandos de Artisan empiezan con php artisan. Estos son los que más usarás al principio:

# Arrancar servidor de desarrollo
php artisan serve

# Con Sail
./vendor/bin/sail up

# Detener Sail
./vendor/bin/sail down

# Ver todos los comandos de Artisan
php artisan list

Ejercicios

Ejercicio 1: Crear un proyecto

Crea un nuevo proyecto Laravel llamado "blog" usando el método que prefieras (instalador o Composer). Arranca el servidor y verifica que funciona en el navegador.

Ejercicio 2: Explorar el archivo .env

Abre el archivo .env de tu proyecto y cambia el valor de APP_NAME por "Mi Blog". Recarga la página y observa si hay algún cambio visible.

Ejercicio 3: Explorar Artisan

Ejecuta php artisan list en tu terminal y explora los comandos disponibles. Identifica al menos 5 comandos que creas que serán útiles durante el desarrollo.