Lección 5 de 26
Cuando abres por primera vez la carpeta de Cursalia y ves decenas de carpetas y archivos, es normal pensar "¿y ahora qué hago con todo esto?". Tranquilo: en esta lección abrimos el capó y te explico qué hace cada parte como si fuera una casa. Al terminar, sabrás moverte sin perderte.
No necesitas memorizar nada. Solo quédate con la idea general de "dónde vive cada cosa". Lo demás llega con la práctica.
La estructura de un proyecto Laravel, como una casa
Cursalia está construida con Laravel (el motor). Todos los proyectos Laravel tienen la misma organización de carpetas, así que lo que aprendas aquí te sirve para siempre. Esto es lo que verás al abrir la carpeta:
cursalia/
├── app/ → el "cerebro": la lógica de la aplicación
├── resources/
│ └── views/ → las "habitaciones": lo que ve el visitante (páginas)
├── routes/ → el "GPS": qué dirección lleva a qué página
├── public/ → la "puerta de entrada": lo único visible desde internet
├── database/ → los "planos": estructura de la base de datos
├── config/ → el "cuadro de luces": ajustes generales
└── .env → las "llaves": contraseñas y datos secretosLas 4 carpetas que de verdad vas a tocar
1. resources/views — lo que ve tu visitante
Aquí viven las páginas (la portada, el blog, el contacto…). Si quieres cambiar un texto o el diseño de una página, es aquí.
2. routes — las direcciones de tu web
Define qué pasa cuando alguien entra a /contacto o /blog. Es el GPS que conecta cada dirección con su página.
3. public — la puerta de entrada
Es la única carpeta visible desde internet. Aquí van las imágenes y los archivos públicos. (Recuerda esto: en el hosting, el dominio debe apuntar a public.)
4. .env — tus llaves secretas
Un archivo con tus contraseñas y configuración (base de datos, correo…). Nunca se comparte ni se sube a internet.
Importante: el archivo .env contiene tus contraseñas. No lo subas nunca a GitHub ni se lo pases a nadie.
Y el resto, ¿para qué sirve?
Las demás carpetas (app, config, database, vendor…) las usa Laravel por dentro. Las irás conociendo a medida que avances, pero no necesitas tocarlas para tener tu academia funcionando.
La carpeta vendor (que pesa mucho) son las "piezas" que instaló Composer. Nunca se edita a mano y por eso no se sube a GitHub: se vuelve a generar con composer install.
Resumen
- Todos los proyectos Laravel comparten la misma estructura: apréndela una vez, úsala siempre.
- Las 4 carpetas clave para ti:
resources/views(páginas),routes(direcciones),public(lo visible) y.env(secretos). - El resto lo gestiona Laravel: no hace falta tocarlo para empezar.
En la próxima lección verás cómo viaja una página desde que el visitante escribe la dirección hasta que ve el resultado. Es más fácil de lo que parece.
¿Aún no tienes Cursalia?
Descárgala gratis y abre la carpeta mientras lees esta lección.
Preguntas frecuentes
Escrito por
Equipo Cursalia
Creamos Cursalia, el LMS gratuito y de código abierto para que cualquiera monte su academia online en su propio dominio.