Upload e validação de imagens 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:007:56

Upload e validação de imagens em Laravel

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

Clase 19 de 29

Clase 19 / 29

Comentarios (4)4 comentarios

Diego Reales

Hace 3 años

Laravel lo hace muy fácil

Hugo Andres Benjumea Alvear

Hace 3 años

Así es

Giovanny Herrera garcia

Hace 3 años

¿Como le funciona el proceso de actualización con el método POST, no se supone que debería ser PUT?

"message": "The POST method is not supported for route api/recipes/103. Supported methods: GET, HEAD, PUT, PATCH, DELETE.",

Gilberto Pérez Garrido

Hace 2 años

Anterior mente se dijo que en el body

"_method": "PUT"

automáticamente lo reconoce laravel al abstraer las rutas o usa la forma explícita

Route::put('/recipes/{recipe}', [RecipeController::class, 'update']);

Juan Pablo Campuzano Monsalve

Hace 2 años

Es que al enviar datos cómo form-data dentro de postman, este simula lo que se haría desde un Navegador. Por lo que, se necesita enviar el campo _method: PUT, ya que el navegador en si, solo reconoce dos metodos HTTP, los cuales son get y post, de resto los demás no son reconocidos a la hora de hacer solicitudes a un endpoint. Espero me haya explicado bien!

Dave Juanes

Hace un año

Profe Italo, que pasa en el caso de editar el registro, se debe borrar la anterior imagen para evitar el peso en el servidor? o en otro caso se prefiere conservar los datos aunque serian inaccesibles

Harold German Granados Guerrero

Hace 3 años

Tener en cuenta al actualizar debe estar en POST y agregar una filla con _method y el valor como PUT

Recursos

Carregar imagens em uma API Laravel exige mais do que um simples campo de texto: precisa de tratamento de ficheiros, armazenamento organizado e validação de formato. Vais aprender como permitir upload de imagens no controlador de receitas, guardá las numa pasta pública e bloquear ficheiros que não cumpram o formato esperado.

Este fluxo é útil para qualquer programador que esteja a construir um CRUD com Laravel e queira adicionar uma camada extra de segurança ao processo administrativo.

Como permitir o upload de uma imagem no controlador?

O ponto de partida está no método de criação do recurso. Em vez de tratar a imagem como texto, tens de a tratar como ficheiro através da classe Request, que gere todo o pedido enviado pelo cliente.

No controlador, dentro do método que cria a receita, usas o método file para apanhar o campo de imagem e o método store para guardar o ficheiro numa pasta organizada. A estrutura básica fica assim:

php $receita->imagem = $request->file('imagem')->store('receitas', 'public'); $receita->update();

A pasta receitas será criada automaticamente dentro de app/public, que é onde o Laravel armazena ficheiros acessíveis publicamente. O método update garante que a alteração no registo é persistida.

Onde o Laravel guarda imagens com store? Por defeito, o método store coloca o ficheiro em storage/app/public dentro da subpasta que indicas. No exemplo, fica em storage/app/public/receitas.

Como testar o upload no Postman?

Para validar o endpoint, usas o Postman com uma requisição POST já autenticada. O detalhe importante está no campo da imagem: por defeito, o Postman aceita texto, mas precisas de mudar o tipo do campo.

Posiciona te sobre o campo imagem no body do tipo form data.
Clica no ícone que aparece e troca text por file.
Seleciona o ficheiro do teu computador e clica em open.
Envia a requisição e confirma que a rota da imagem é devolvida no resultado.

Depois de enviar, vais ver no projeto que a pasta foi criada e a imagem foi armazenada com um nome único gerado pelo Laravel [03:15].

Como validar que o ficheiro é uma imagem?

Aqui entra a camada de segurança. Sem validação, qualquer utilizador pode tentar carregar ficheiros que não são imagens, o que abre brechas no teu sistema. A solução está nas regras de validação dentro da classe Request.

No ficheiro de Request associado ao recurso, adicionas as regras ao campo imagem. A regra required obriga o envio e a regra image garante que o ficheiro é uma imagem válida. Podes ainda restringir formatos específicos:

php 'imagem' => 'required|image|mimes:png,jpg'

Se tentares enviar um PNG quando a regra exige apenas JPG, o Laravel devolve imediatamente um erro a indicar que o formato não é aceite. Ao corrigir para PNG ou ajustar a regra, o registo é criado com sucesso.

O que faz a regra image no Laravel? Verifica se o ficheiro carregado tem uma extensão válida de imagem como jpg, png, bmp, gif, svg ou webp. É a forma mais rápida de filtrar uploads inválidos.

Na documentação oficial do Laravel, na secção de Validation, encontras a lista completa de regras disponíveis. Vale a pena explorar a regra max para limitar o peso do ficheiro e a regra size para controlar dimensões, ambas muito úteis quando trabalhas diretamente com ficheiros [05:20].

Como atualizar uma receita com imagem opcional?

A atualização tem uma lógica diferente da criação. Ao atualizar, não queres obrigar o utilizador a enviar sempre uma imagem nova; ele pode querer alterar apenas o título ou outro campo.

A solução passa por uma verificação condicional dentro do método update do controlador. Perguntas se o pedido inclui um ficheiro e, só nesse caso, executas o upload:

php if ($request->file('imagem')) { $receita->imagem = $request->file('imagem')->store('receitas', 'public'); } $receita->update();

Desta forma, a imagem só é substituída quando o utilizador realmente envia uma nova. Os restantes campos são atualizados normalmente, sem forçar uploads desnecessários.

Como testar a atualização no Postman?

Para testar este endpoint precisas de estar autenticado com um token válido. O truque está em manter o método POST mas adicionar um campo extra que indique ao Laravel que se trata de uma atualização.

Mantém a requisição como POST com o ID do recurso na URL, por exemplo /receitas/107.
Adiciona um campo chamado _method com o valor put.
Envia os campos que queres atualizar, como o título.
Confirma na resposta que o registo foi modificado.

Este padrão é necessário porque o form data com ficheiros não suporta nativamente o método PUT. O Laravel reconhece o campo _method e processa a requisição como atualização [07:45].

Faz este exercício no teu projeto, testa com diferentes formatos de imagem e partilha nos comentários que regras de validação adicionais aplicaste ao teu sistema.

Resumen

Este fluxo é útil para qualquer programador que esteja a construir um CRUD com Laravel e queira adicionar uma camada extra de segurança ao processo administrativo.

Como permitir o upload de uma imagem no controlador?

php $receita->imagem = $request->file('imagem')->store('receitas', 'public'); $receita->update();

Onde o Laravel guarda imagens com store? Por defeito, o método store coloca o ficheiro em storage/app/public dentro da subpasta que indicas. No exemplo, fica em storage/app/public/receitas.

Como testar o upload no Postman?

Posiciona te sobre o campo imagem no body do tipo form data.
Clica no ícone que aparece e troca text por file.
Seleciona o ficheiro do teu computador e clica em open.
Envia a requisição e confirma que a rota da imagem é devolvida no resultado.

Depois de enviar, vais ver no projeto que a pasta foi criada e a imagem foi armazenada com um nome único gerado pelo Laravel [03:15].

Como validar que o ficheiro é uma imagem?

php 'imagem' => 'required|image|mimes:png,jpg'

O que faz a regra image no Laravel? Verifica se o ficheiro carregado tem uma extensão válida de imagem como jpg, png, bmp, gif, svg ou webp. É a forma mais rápida de filtrar uploads inválidos.

Como atualizar uma receita com imagem opcional?

A atualização tem uma lógica diferente da criação. Ao atualizar, não queres obrigar o utilizador a enviar sempre uma imagem nova; ele pode querer alterar apenas o título ou outro campo.

A solução passa por uma verificação condicional dentro do método update do controlador. Perguntas se o pedido inclui um ficheiro e, só nesse caso, executas o upload:

php if ($request->file('imagem')) { $receita->imagem = $request->file('imagem')->store('receitas', 'public'); } $receita->update();

Desta forma, a imagem só é substituída quando o utilizador realmente envia uma nova. Os restantes campos são atualizados normalmente, sem forçar uploads desnecessários.

Como testar a atualização no Postman?

Mantém a requisição como POST com o ID do recurso na URL, por exemplo /receitas/107.
Adiciona um campo chamado _method com o valor put.
Envia os campos que queres atualizar, como o título.
Confirma na resposta que o registo foi modificado.

Este padrão é necessário porque o form data com ficheiros não suporta nativamente o método PUT. O Laravel reconhece o campo _method e processa a requisição como atualização [07:45].

Faz este exercício no teu projeto, testa com diferentes formatos de imagem e partilha nos comentários que regras de validação adicionais aplicaste ao teu sistema.

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

Upload e validação de imagens em Laravel