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:
- Descarga el esqueleto de Laravel más reciente desde el repositorio oficial.
- Instala todas las dependencias de Composer dentro de la carpeta
vendor/. - Copia el archivo
.env.examplecreando tu archivo de configuración.env. - Genera una clave criptográfica única de 32 caracteres ejecutando
php artisan key:generate(almacenada enAPP_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.
# 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¿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.