Migrações e relações de dados em Laravel

Curso de Estándares y Buenas Prácticas para API REST con Laravel

Contenido del curso

Buenas prácticas a nivel general

Creación del proyecto

Planificación y mantenimiento

Funciones de seguridad

API Testing

API Breaking Changes

Conclusiones

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0011:58

Migrações e relações de dados em Laravel

Curso de Estándares y Buenas Prácticas para API REST con Laravel

Clase 4 de 29

Clase 4 / 29

Recursos

Definir a estrutura inicial de dados em Laravel API é o primeiro passo para construir uma base sólida antes de programar endpoints. Aqui vais aprender a criar tabelas, migrações e relações one-to-many e many-to-many aplicando boas práticas que funcionam em qualquer framework profissional.

Que versões e ferramentas precisas para começar?

Antes de gerar o projeto, confirma que o teu ambiente está alinhado com as versões recomendadas. Isto evita conflitos durante a instalação e ao correr migrações.

Instalador do Laravel atualizado [0:25].
PHP 8.2.6 ou superior [0:30].
Composer 2.5.7 ou superior [0:35].
MariaDB como base de dados, embora o Laravel seja flexível com outras tecnologias [0:42].

O projeto começa com o comando laravel new laravel-api dentro da tua pasta de sites [1:10]. A partir daí, todo o trabalho acontece no terminal integrado do Visual Studio Code.

O que é uma migração no Laravel? É um ficheiro PHP que descreve a estrutura de uma tabela e permite versionar a base de dados. Cada migração pode ser executada ou revertida com um comando.

Como gerar modelos, fábricas e migrações com Artisan?

O comando php artisan make:model é o ponto de partida. Combinado com flags adicionais, cria simultaneamente o modelo, a factory e a migração correspondente, poupando passos manuais [2:30].

Neste projeto, vais criar três entidades centrais:

Category, que agrupa receitas.
Recipe, a entidade principal de cozinha.
Tag, que permite etiquetar receitas com múltiplos elementos.

A decisão de modelar assim responde a uma necessidade clara: uma categoria contém várias receitas (relação one-to-many) e uma receita pode ter várias etiquetas (relação many-to-many) [3:15]. Esta combinação cobre os dois cenários mais comuns em qualquer API real.

Que campos precisa cada tabela?

A migração de categories precisa apenas de um campo name do tipo string além dos campos automáticos id, created_at e updated_at [4:00]. A tabela de tags segue exatamente a mesma estrutura.

A migração de recipes é mais rica porque carrega o peso das relações e do conteúdo:

category_id como unsignedInteger com chave estrangeira referenciando categories.id [4:45].
user_id com chave estrangeira para users.id, ambos com onDelete cascade [5:30].
title do tipo string.
description do tipo text.
ingredients e instructions para o conteúdo da receita.
image como campo opcional, já que vais carregar imagens via API [6:10].

O efeito cascade garante que, ao eliminar uma categoria ou utilizador, as receitas associadas desaparecem automaticamente. É uma forma de manter a integridade referencial sem registos órfãos.

Como criar a tabela pivot para relações muitos-para-muitos?

Quando duas entidades se relacionam em many-to-many, precisas de uma tabela intermediária chamada pivot. No Laravel existe uma convenção de nomenclatura que deves respeitar para que o framework reconheça a relação automaticamente.

O comando é php artisan make:migration create_recipe_tag_table [7:20]. Repara em dois detalhes da convenção:

Os nomes das entidades vão no singular, ao contrário das tabelas normais que vão no plural.
A ordem é alfabética: recipe antes de tag.

Por que a tabela pivot usa nomes no singular? Porque o Laravel infere o nome a partir dos modelos relacionados, que sempre são singulares. Quebrar esta regra obriga-te a configurar a relação manualmente.

Dentro desta migração registas dois campos: recipe_id e tag_id, ambos como chaves estrangeiras com cascade. Os campos created_at e updated_at são eliminados porque numa tabela pivot raramente fazem sentido [8:40].

Por que usar onDelete cascade nas relações?

O cascade propaga a eliminação. Se apagas um utilizador, todas as receitas dele somem. Se apagas uma receita, as ligações na tabela pivot também desaparecem. Sem isto, ficavas com dados inconsistentes a ocupar espaço e a quebrar consultas.

Que conceitos de modelagem deves dominar?

A estrutura criada cobre os fundamentos que vais reencontrar em qualquer framework profissional, seja Django, Rails ou Spring. Os pilares são:

Migrações versionadas para controlar mudanças no schema.
Modelos que representam entidades do domínio.
Factories para gerar dados de teste de forma rápida.
Chaves estrangeiras com regras de integridade como cascade.
Tabelas pivot com convenções de nomenclatura claras.

O resultado final são quatro migrações que formam a base do projeto: categories, recipes, tags e recipe_tag. A partir daqui, qualquer endpoint que construas vai apoiar-se nesta fundação.

Pratica este exercício no teu próprio ambiente e conta nos comentários se estás a usar outro framework. A lógica de relações e migrações replica-se em todos eles, só muda a sintaxe.

Kenneth Angulo L

Hace 2 años

Las clases de Italo son asi, muy bien estructuradas, aqui estamos reuniendo los recursos (modelos, tablas) con los que vamos a trabajar en el proyecto.

Tengo dudas sobre el borrado en cascada con las categorias, porque si elimino la categoria elimino tambien todas las recetas que tenga asociadas, en terminos de UX pienso es mejor advertir al usuario 'x cantidad de recetas quedaran huerfanas, o algo asi'.

Dicho eso, comparto mi version de la migracion :

Schema::create('recipes', function (Blueprint $table) {

$table->id();

$table->foreignIdFor('category_id')->constrained();

$table->foreignIdFor('user_id')->constrained()->onDelete('cascade');

$table->string('title');

$table->text('description');

$table->text('ingredients');

$table->text('instructions');

$table->string('image')->nullable();

$table->timestamps();

});

Comentarios (13)13 comentarios

J. Sebastián Botello. H.

Hace 3 años

No es que tenga algo en contra de PHP pero para un curso que se llame "API REST, estandares y buenas prácticas" debería estar enfocado en eso. Y no meter ningún tipo de lenguaje.. opino humildemente.

Platzi Team

De acuerdo,

Jean Garcia

Hace un año

No entiendo este comentario, "ningún tipo de lenguaje" para crear una API sí por que sí debes usar un lenguaje de programación, y en el caso que ocupa el curso API REST con Laravel, Laravel es un framework PHP ;-)

Jose Carlos Florez Vergara

esta instrucción es valida para las llaves foraneas

$table->foreignIdFor(Category::class)->constrained()->onDelete('cascade');

Eduardo Pajarito

En mi opinión es mas fácil de manejar :)

Johan Camilo Lozano Ramirez

Hace un año•editado

Para aquellos que al instalar Laravel les trae una versión mas reciente pueden crear el proyecto con la versión especifica que usa el profe (10.2.4)

composer create-project --prefer-dist laravel/laravel:10.2.4 laravel-api

Steven García

No entiendo esta clase. si alguien me puede apoyar, no me queda claro cuales son los conceptos que esta explicando. y en todo la clase me dio la impresion de solo estar codeando contruyendo la api.

Iván González Mendoza

En la sección de recursos hay un enlace para ver el código del proyecto que esta utilizando. Aquí no hay tanto una explicación de conceptos de convenciones de creación de API, sino más bien la construcción de un ejemplo con el que, más adelante, se demostrará como deben aplicarse los principios que se demostrarán en el curso.

Juan Manuel Ortiz Suárez

Puedo desarrollar el curso con FastAPI de Python?

Comparto por aqui las diferentes opciones que tenemos para crear las llaves foraneas (ninguna es mejor que otra, solamente debemos apegarnos a un estandar cuando desarrollemos y ser consistentes)

Alvaro Huaysara Jauregui

Así se haría la petición en dart

import 'dart:async';
import 'package:http/http.dart' as http;

Future<void> main() async {
  // URL de la API XKCD
  var url = Uri.parse('https://xkcd.com/info.0.json');

  // Realizar la petición GET
  var response = await http.get(url);

  // Verificar si la petición fue exitosa (código de estado 200)
  if (response.statusCode == 200) {
    // Imprimir la respuesta
    print('Respuesta de la API XKCD:');
    print(response.body);
  } else {
    // Si la petición falla, imprimir el código de estado
    print('Error al realizar la petición: ${response.statusCode}');
  }
}

Juan Pablo Campuzano Monsalve

Excelente, no conocía este lenguaje de programación hasta leer tu comentario jajajja

GERARDO JOSE VILLEDA ERAZO

Hace 9 meses

php artisan make:migration create_recipe_tag_table

Esteban Xavier Moyolema Paz

Qué bueno un profe serio, no como el muchachito de la clase anterior!

William Villegas

antes de andar hablando deberías ver sus cursos primero para que te des cuenta que es muy buen profesor al igual que italo

Jorge Luis Callalle Torres

Buenas, requieren que haya instalado Laravel? para el Curso

Axel Isaac

Puedes instalar Laravel si lo deseas, pero la orientacion del curso va mas a aprender las bases del desarrollo Backend, los cuales pueden aplicarse en cualquier tipo de framework o lenguaje de programacion.

Juan Sebastián Joya Rodríguez

Es preferible que lo instales, igual en el curso de laravel tel lo enseñan a hacer de forma sencilla

Carlos Palacios

Dejo mi codigo en JavaScript usando express.js --> https://github.com/CarlosArgelio/javascript-api/commit/2ecf136ad20774f488c6b2aa16bf35dc16598983

Ivan Sosa Tovar

Comparto Descargar Composer-Setup.exe: Visita el sitio web oficial de Composer (https://getcomposer.org/download/) y descarga el instalador de Composer llamado "Composer-Setup.exe". Este instalador simplificará el proceso de instalación de Composer en Windows. para instalar Laravel y crear el proyecto con laravel composer create-project --prefer-dist laravel/laravel nombre-del-proyecto

Buenas prácticas a nivel general

Buenas prácticas para diseñar una API REST

¿Qué son los HTTP Status Codes?

Qué hace cada método HTTP

Creación del proyecto

Migrações e relações de dados em Laravel

Factories y seeders para poblar tu API en Laravel

Consultas API con Laravel: Rutas y Controladores

Consultas con relaciones en Laravel API

Planificación y mantenimiento

Planificación de rutas REST en Laravel

Recursos y colecciones en Laravel API

Recursos anidados en Laravel API

Cómo reducir 932 consultas con Telescope

CRUD de Recetas con Laravel y Symfony en Visual Studio Code

Validación de Datos en Aplicaciones Web con Laravel

Funciones de seguridad

Autenticación vs. autorización

Proteger rutas de API con Sanctum

Ruta de login y tokens con Sanctum

Corrección de bugs de seguridad en aplicaciones web

Políticas de acceso en Laravel con Artisan

Upload e validação de imagens em Laravel

Qué es autenticación en la web

API Testing

Automatiza pruebas de API en Laravel

Testing de Módulos Administrativos en Visual Studio Code

Testing de recetas con PHP Artisan

Pruebas de Creación de Datos en Aplicaciones Web

Test de actualización de recetas en Laravel

API Breaking Changes

Versionado de API en Laravel con v1 y v2

Desarrollo de API con TDD: Implementación de Versión 2

Conclusiones

Desarrollo de API RESTful con Laravel: Buenas Prácticas y Seguridad

Buenas prácticas finales para tu API en Laravel

Migrações e relações de dados em Laravel