20. Estructura del Framework Laravel

 Estructura del Framework Laravel: Una Guía Rápida

Antes de sumergirnos en el código de Laravel, es fundamental entender su arquitectura y organización. Este conocimiento es la base para desarrollar aplicaciones de manera eficiente y mantener un código ordenado.

El Patrón MVC y las Peticiones HTTP

Laravel adopta el patrón de diseño Modelo-Vista-Controlador (MVC), que separa la lógica de la aplicación en tres componentes principales para una mejor organización y mantenibilidad. La comunicación con la base de datos y el cliente se maneja principalmente a través de los verbos HTTP, siendo los cuatro principales:

  • GET: Se utiliza para solicitar o leer datos del servidor.

  • POST: Se utiliza para crear nuevos datos o registros.

  • PUT: Se utiliza para actualizar datos existentes por completo.

  • DELETE: Se utiliza para eliminar datos.

Estos métodos definen las acciones que se pueden realizar en nuestra API o aplicación web.

Desglose de la Estructura de Carpetas

El patrón MVC se refleja físicamente en la estructura de carpetas de un proyecto Laravel. Veamos las más importantes:

1. Vistas (resources/views)

Aquí es donde se almacenan todos los archivos que renderizan la interfaz de usuario, típicamente escritos en Blade (el motor de plantillas de Laravel) o como archivos simples de HTML. Por ejemplo, la vista de bienvenida que ves al instalar Laravel por primera vez (welcome.blade.php) se encuentra en esta carpeta.

Nota para APIs REST: En el desarrollo de una API pura, donde la respuesta es JSON y no HTML, no se utilizan las vistas. El foco está en los controladores y modelos.

2. Controladores (app/Http/Controllers)

Esta carpeta alberga todos los controladores de tu aplicación. Los controladores son los intermediarios: reciben las peticiones HTTP, interactúan con los modelos para obtener datos y devuelven una respuesta (una vista o datos JSON).
Al instalar Laravel, encontrarás controladores base para la autenticación (Login, Register, etc.) en las subcarpetas Auth y Controllers. Aquí es donde crearás tus propios controladores para manejar la lógica de negocio.

3. Modelos (app/Models)

Los modelos representan las entidades de tu aplicación y te permiten interactuar con las tablas de la base de datos de una manera orientada a objetos. Por defecto, Laravel incluye el modelo User.php para gestionar la autenticación. Tus modelos personalizados (como Product, Post, etc.) se crearán y almacenarán aquí.

4. Rutas (routes/)

Las rutas son el mapa de tu aplicación; definen las URLs y a qué controlador o lógica deben dirigirse.

  • web.php: Aquí se definen las rutas para tu aplicación web estándar, típicamente aquellas que devuelven vistas y manejan sesiones y cookies.

  • api.php: Este archivo está destinado a las rutas de tu API REST. Las rutas definidas aquí se prefijan automáticamente con /api y están optimizadas para stateless requests (sin estado, como tokens).

5. Recursos Públicos (public/)

Esta es la carpeta raíz accesible desde el navegador. Aquí debes colocar todos los assets públicos de tu proyecto frontend: hojas de estilo CSS, scripts JavaScript, imágenes, fuentes, etc. Si estás construyendo una aplicación web, aquí crearás subcarpetas como /css, /js e /img.

Artisan: El Asistente Indispensable

Laravel incluye una potente herramienta de línea de comandos llamada Artisan. Artisan nos ahorra una enorme cantidad de trabajo automatizando tareas repetitivas. Con simples comandos, podemos:

  • Crear nuevos controladores, modelos, migraciones, etc.

  • Ejecutar migraciones de la base de datos.

  • Listar todas las rutas definidas.

  • Generar código boilerplate rápidamente.

Ejemplos:

bash
# Crear un nuevo controlador
php artisan make:controller MiController

# Crear un nuevo modelo
php artisan make:model Producto

Resumen: API vs Aplicación Web

  • Para una API REST: Tu flujo de trabajo se centrará en Modelos, Controladores y las rutas definidas en api.php. El controlador procesará la solicitud, usará el modelo y devolverá una respuesta JSON.

  • Para una Aplicación Web tradicional: Utilizarás el flujo completo: Vistas, Controladores, Modelos, la carpeta public/ para los assets y las rutas definidas en web.php.

¿Quieres aprender a construir una aplicación web completa con Laravel, incluyendo vistas, estilos y lógica de negocio? Te recomiendo explorar cursos más extensos que cubran MVC, Programación Orientada a Objetos y el ecosistema completo de Laravel.

¡Espero que esta guía te ayude a orientarte en tu próximo proyecto con Laravel!

Comentarios

Publicar un comentario

Entradas más populares de este blog

crear controladores separados para API y Web

  crear controladores separados para API y Web. Te explico por qué y te muestro cómo hacerlo: ¿Por qué separar los controladores? Separación de responsabilidades : Cada controlador tiene un propósito específico Mantenimiento más fácil : Cambios en API no afectan la web y viceversa Diferentes lógicas : API necesita manejo de JSON, autenticación diferente, etc. Mejor organización : Código más limpio y escalable Estructura recomendada bash # Controlador para Web php artisan make:controller Web/ProductController --resource --model = Product # Controlador para API php artisan make:controller Api/ProductController --resource --model = Product 1. Controlador para API app/Http/Controllers/Api/ProductController.php : php <?php namespace App \ Http \ Controllers \ Api ; use App \ Http \ Controllers \ Controller ; use App \ Models \ Product ; use Illuminate \ Http \ JsonResponse ; use Illuminate \ Http \ Request ; class ProductController extends Controller { /*...
Leer más

Laravel tanto para web como para API al mismo tiempo.

  Te explico cómo crear un CRUD completo en Laravel tanto para web como para API al mismo tiempo. 1. Configuración Inicial Primero, crea el modelo con migración y controlador: bash php artisan make:model Product -mcr 2. Migración database/migrations/xxxx_create_products_table.php : php <?php use Illuminate \ Database \ Migrations \ Migration ; use Illuminate \ Database \ Schema \ Blueprint ; use Illuminate \ Support \ Facades \ Schema ; return new class extends Migration { public function up ( ) : void { Schema :: create ( 'products' , function ( Blueprint $table ) { $table -> id ( ) ; $table -> string ( 'name' ) ; $table -> text ( 'description' ) -> nullable ( ) ; $table -> decimal ( 'price' , 10 , 2 ) ; $table -> integer ( 'stock' ) ; $table -> timestamps ( ) ; } ) ; } public functi...
Leer más

Creación de una API RESTful con Laravel (sin autenticación)

    Tutorial: Creación de una API RESTful con Laravel (sin autenticación) Aquí te muestro cómo crear una API básica en Laravel sin sistema de autenticación, ideal para prototipos rápidos o APIs públicas. Paso 1: Crear el proyecto bash laravel nuevo api-simple # O composer create-project laravel/laravel api-simple cd api-simple Paso 2: Configurar la base de datos Edita el archivo  .env : env DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=api_simple DB_USERNAME=root DB_PASSWORD= Paso 3: Crear modelo, migración y controlador Vamos a crear un modelo  Publicacion : bash php artisan make:model Publicacion -mcr Paso 4: Definir la migración Edita  database/migrations/xxxx_create_publicacions_table.php : php public function up ( ) { Schema :: create ( 'publicacions' , function ( Blueprint $table ) { $table -> id ( ) ; $table -> string ( 'titulo' ) ; $table -> text ( 'contenido' ) ; $table -> s...
Leer más