Primeros pasos con Laravel y Composer para principiantes

Introducción

En este tutorial aprenderás a crear tu primer proyecto con Laravel utilizando Composer, desde la instalación de las herramientas necesarias hasta tener tu aplicación funcionando en el navegador. Laravel es un framework de PHP que sigue el patrón MVC (Modelo-Vista-Controlador) y es ampliamente utilizado por su elegancia y facilidad de uso .

---

Requisitos previos

Antes de comenzar, necesitas tener instalado:

Requisito	Versión mínima	Comando para verificar
PHP	8.2 o superior	php -v
Composer	Última versión estable	composer -v
MySQL o SQLite	5.7 / 8.0 o SQLite 3	mysql --version

Si no tienes PHP instalado, Laravel ofrece una forma sencilla de instalar todo con un solo comando . Recomendamos seguir las instrucciones oficiales en laravel.com según tu sistema operativo.

Nota importante: Después de instalar las herramientas, reinicia tu terminal para que los cambios se apliquen globalmente y evites errores de "comando no encontrado" .

---

Paso 1: Verificar las instalaciones

bash

# Verificar versión de PHP
php -v

# Verificar Composer
composer -v

Si ves las versiones correctas, ¡estás listo para empezar!

---

Paso 2: Crear un nuevo proyecto Laravel

2.1 Usando Composer (recomendado)

El comando principal para crear un proyecto Laravel es :

bash

composer create-project laravel/laravel nombre-del-proyecto

Ejemplo:

bash

composer create-project laravel/laravel mi-primer-proyecto

2.2 Usando el instalador de Laravel (alternativa)

Si instalaste el instalador de Laravel globalmente:

bash

laravel new mi-primer-proyecto

2.3 Preguntas durante la instalación

Al ejecutar el comando, el instalador te hará algunas preguntas :

Pregunta	Opción recomendada	Explicación
Starter Kit	"None"	Empezamos desde cero para entender el framework
Testing framework	Default (Pest)	Para pruebas automatizadas
Database	sqlite o mysql	SQLite es más sencillo para empezar
Run npm install?	"yes"	Instala dependencias JavaScript

Ejemplo de flujo completo:

bash

laravel new mi-primer-proyecto

# Preguntas que verás:
# - Starter Kit: Selecciona "None"
# - Testing framework: Presiona Enter (default)
# - Database: Selecciona "sqlite"
# - Run npm install? Selecciona "yes"

---

Paso 3: Explorar la estructura del proyecto

Después de la instalación, navega al proyecto:

bash

cd mi-primer-proyecto
ls -la

Estructura de directorios principales

Directorio/Archivo	Descripción
app/	Código principal de la aplicación (Modelos, Controladores)
bootstrap/	Archivos de arranque del framework
config/	Configuraciones de la aplicación
database/	Migraciones, seeders y fábricas
public/	Punto de entrada pública (index.php)
resources/views/	Plantillas Blade (HTML)
routes/	Definición de rutas web/api
storage/	Archivos generados (logs, caché)
tests/	Pruebas automatizadas
vendor/	Dependencias de Composer
.env	Configuración de entorno (¡importante!)
composer.json	Definición de dependencias

---

Paso 4: Configurar el archivo .env

El archivo .env contiene la configuración sensible de tu aplicación. Laravel genera uno automáticamente, pero puede que necesites ajustarlo :

bash

# Abrir el archivo .env
nano .env

Configuración básica para base de datos MySQL:

text

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nombre_de_tu_bd
DB_USERNAME=tu_usuario
DB_PASSWORD=tu_contraseña

Si usas SQLite (más sencillo para empezar):

text

DB_CONNECTION=sqlite

---

Paso 5: Generar la clave de la aplicación

Laravel necesita una clave única para encriptación. Generala con:

bash

php artisan key:generate

Salida esperada:

text

Application key set successfully.

---

Paso 6: Ejecutar el servidor de desarrollo

Laravel incluye un servidor de desarrollo integrado:

bash

php artisan serve

Salida esperada:

text

Starting Laravel development server: http://127.0.0.1:8000

Opciones útiles del servidor

Comando	Descripción
php artisan serve --host=0.0.0.0	Servir en todas las interfaces de red
php artisan serve --port=8080	Usar un puerto diferente

---

Paso 7: Ver tu aplicación en el navegador

Abre tu navegador y visita:

text

http://localhost:8000

Deberías ver la página de bienvenida de Laravel 🎉

https://laravel.com/img/hero.png

---

Paso 8: Comandos básicos de Laravel Artisan

8.1 Ver todos los comandos disponibles

bash

php artisan list

8.2 Crear un controlador

bash

php artisan make:controller UsuarioController

8.3 Crear un modelo con migración

bash

php artisan make:model Producto -m

8.4 Ejecutar migraciones

bash

php artisan migrate

8.5 Ver todas las rutas

bash

php artisan route:list

---

Paso 9: Configurar tu editor de código

Recomendación: Visual Studio Code

VS Code es una excelente opción para desarrollar con Laravel. Instala estas extensiones :

Extensión	Beneficio
Laravel Extension Pack	Paquete completo de herramientas
PHP Intelephense	Autocompletado avanzado
Blade Formatter	Formateo de vistas
SQLite	Visualización de bases de datos

---

Solución de problemas comunes

Error: "command not found: composer"

Causa: Composer no está instalado o no está en el PATH.

Solución: Instala Composer siguiendo las instrucciones en getcomposer.org o reinicia tu terminal .

Error: "Your requirements could not be resolved"

Causa: Versión de PHP incompatible o extensiones faltantes.

Solución: Verifica que tienes PHP 8.2+ instalado :

bash

php -v

Error: "Could not connect to database"

Causa: Configuración incorrecta en .env.

Solución: Verifica las credenciales de tu base de datos en el archivo .env :

bash

# Verificar la configuración
php artisan config:clear

Error: "No application key"

Causa: No has generado la clave de la aplicación.

Solución:

bash

php artisan key:generate

Comandos rápidos de referencia

Comando	Descripción
composer create-project laravel/laravel nombre	Crear nuevo proyecto
php artisan serve	Iniciar servidor de desarrollo
php artisan make:controller NombreController	Crear controlador
php artisan make:model Nombre -m	Crear modelo con migración
php artisan migrate	Ejecutar migraciones
php artisan route:list	Ver todas las rutas
php artisan key:generate	Generar clave de aplicación
php artisan tinker	Consola interactiva de Laravel
composer require paquete	Instalar paquete de Composer

---

Resumen de versiones (2025-2026)

Actualmente, Laravel 11 es la versión recomendada para nuevos proyectos :

• Laravel 11 requiere: PHP 8.2 o superior 

• Opciones de base de datos: SQLite, MySQL 8.0+, PostgreSQL 15+, MariaDB 10.5+

---

¡Felicidades! 🎉 Has creado tu primera aplicación Laravel. Ahora tienes un punto de partida sólido para comenzar a desarrollar. En los siguientes pasos, podrás explorar la creación de rutas, controladores, vistas y modelos para construir tu aplicación completa