Tema 2 · Instalación & Estructura

2. Instalación de un Proyecto (Composer / Installer) y Anatomía de Carpetas

Crea tu primera aplicación con Composer, domina el servidor Artisan integrado y recorre las carpetas esenciales de Laravel.

Creando tu Primer Proyecto con Composer

La forma estándar y universal de crear un proyecto en Laravel sin importar si usas Windows, Linux o macOS es mediante el comando composer create-project:

composer create-project laravel/laravel mi-academia

Este comando realiza 4 tareas automáticas:

  1. Descarga el esqueleto de Laravel más reciente desde el repositorio oficial.
  2. Instala todas las dependencias de Composer dentro de la carpeta vendor/.
  3. Copia el archivo .env.example creando tu archivo de configuración .env.
  4. Genera una clave criptográfica única de 32 caracteres ejecutando php artisan key:generate (almacenada en APP_KEY).

El Servidor de Desarrollo Integrado: php artisan serve

Para probar tu aplicación en desarrollo no necesitas configurar un VirtualHost complejo en Apache. Desde la raíz de tu proyecto ejecuta:

cd mi-academia
php artisan serve

Artisan levantará un servidor web local en http://127.0.0.1:8000 apuntando automáticamente al directorio público seguro public/.

Anatomía y Estructura de Carpetas en Laravel Moderno

Directorio ¿Qué contiene y para qué se usa?
app/ El corazón de la aplicación: contiene los Modelos (app/Models), Controladores (app/Http/Controllers) y Middlewares.
bootstrap/ Archivos de arranque del framework y configuración centralizada moderna en bootstrap/app.php.
config/ Archivos de configuración global: base de datos (database.php), correo, sesiones y servicios.
database/ Migraciones de tablas (migrations/), fábricas de datos (factories/) y sembradores (seeders/).
public/ Único directorio expuesto a internet: contiene index.php, el .htaccess, imágenes, CSS y JavaScript compilados.
resources/ Vistas Blade sin compilar (views/), archivos CSS y JS fuente (procesados con Vite).
routes/ Definición de rutas: web.php (para navegación web con sesión/cookies) y api.php (para APIs sin estado).
storage/ Archivos generados por el framework: logs (storage/logs/laravel.log), plantillas Blade cacheadas y archivos subidos por usuarios.

⚡ Flujo Completo de Creación y Arranque de un Proyecto Laravel

Comandos en consola desde la creación del proyecto hasta el arranque del servidor de desarrollo.

crear-proyecto-laravel.sh
Solo lectura
# 1. Crear el nuevo proyecto Laravel llamado 'tienda-online'
composer create-project laravel/laravel tienda-online

# 2. Entrar al directorio del proyecto recién creado
cd tienda-online

# 3. Listar la estructura inicial de directorios
ls -la

# 4. Comprobar que la clave criptográfica APP_KEY fue generada en el .env
cat .env | grep "APP_KEY="

# 5. Si la clave estuviera vacía, se puede generar manualmente con:
php artisan key:generate

# 6. Iniciar el servidor local de desarrollo en el puerto 8000
php artisan serve

# En consola verás:
# INFO  Server running on [http://127.0.0.1:8000].
# Press Ctrl+C to stop the server
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el ÚNICO directorio de un proyecto Laravel que debe ser configurado como raíz web (DocumentRoot) en Apache o Nginx?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Laravel Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.