Pôr foto nos produtos da Mini Loja com upload: a foto vai para uma pasta, o banco guarda só o nome dela, e arquivo disfarçado não entra.
Ter a Mini Loja da aula 12 (versão 4). Não tem? Baixe do seu GitHub (Code › Download ZIP) ou copie a versão 4 da aula 12.
Atividade no laboratório, enviada ao GitHub por upload.
Ninguém compra LED sem ver
A Mini Loja já cadastra, lista, edita e exclui. Mas é uma loja de texto: ninguém compra um sensor sem ver a cara dele. Hoje o produto ganha foto, enviada pelo próprio formulário. Isso se chama upload.
Pense no restaurante: o garçom recebe a foto do prato e pendura no cardápio. Só que nem tudo o que chega é foto. Às vezes alguém tenta pendurar um bilhete com ordens no lugar dela. Um garçom distraído pendura. Um garçom esperto confere antes.
| Versão | O que acontece | O garçom... |
|---|---|---|
| 1 | a foto entra na loja | pendura qualquer coisa (e você vai ver o perigo) |
| 2 | a foto é conferida antes de entrar | olha dentro do arquivo e dá um nome novo |
| 3 | editar troca a foto; excluir apaga a foto junto | não deixa foto esquecida na pasta |
Três ideias, e só
O formulário que carrega arquivo
Para levar um arquivo, o formulário precisa de duas coisas: o enctype="multipart/form-data" e um campo type="file".
No PHP, o arquivo não chega no $_POST: chega no $_FILES, com as informações dele.
O erro mais comum: esquecer o enctype. Sem ele, o navegador manda só o nome do arquivo, e a foto fica para trás.
1// o que chega quando alguém envia sensor.jpg2$_FILES['imagem']['name'] // "sensor.jpg": o nome no computador da pessoa3$_FILES['imagem']['tmp_name'] // onde o PHP guardou, por enquanto4$_FILES['imagem']['size'] // o tamanho, em bytes5$_FILES['imagem']['error'] // 0 (UPLOAD_ERR_OK) = chegou inteiro
A foto mora na pasta; o banco anota o nome
A foto vai para a pasta uploads, com o move_uploaded_file. No banco entra só o nome do arquivo, numa coluna nova chamada imagem.
É como a etiqueta do pote na cozinha: o caderno não guarda o açúcar, guarda em que pote ele está.
A tabela já existe, então a coluna entra com ALTER TABLE, uma vez só. O banco.php faz isso sozinho.
1mini-loja/2 index.html // a porta3 cadastro.php // o garçom: confere e guarda a foto4 banco.php // a cozinha: anota o nome da foto5 tela.php // o prato: mostra a foto6 mini-loja.sqlite // só no computador7 uploads/ // NOVO: as fotos (nasce sozinha)8 a3f9c1e07b2d4e88.jpg
O nome pode mentir; o conteúdo, não
Qualquer um renomeia um programa para bolo.jpg. Por isso o garçom confere quatro coisas antes de guardar:
- Chegou inteiro? (
error) - Cabe? Até 2 MB (
size). - É foto de verdade? O
getimagesizeabre o arquivo e olha dentro. Só passam JPG, PNG e WEBP. - Nome novo. O sistema inventa o nome (
random_bytes). O nome que veio da pessoa vai para o lixo.
Por quê? Um arquivo .php na pasta uploads vira um programa no servidor: quem mandou passa a dar ordens à loja. Esse é um dos ataques mais antigos da web.
1// getimagesize abre o arquivo: não é imagem? devolve false2$info = getimagesize($arquivo['tmp_name']);34// o tipo de verdade fica na posição 25$info[2] === IMAGETYPE_JPEG // é uma foto JPEG?67// nome novo: 16 letras e números sorteados8$nome = bin2hex(random_bytes(8)) . '.jpg';
O garçom confere a foto 0 de 6
Chegaram seis arquivos pelo formulário. Você é o garçom: pendura no cardápio ou barra? Leia o nome, o tamanho e, principalmente, o que tem dentro.
Mão na massa: a foto em 3 versões
Cada versão é o projeto inteiro, pronto para copiar. Faça uma de cada vez: copie, salve, recarregue o navegador, leia o "entenda o código" e só depois passe para a próxima.
A meta de hoje: as 3 versões. Não deu tempo? Termine em casa: o passo a passo serve em qualquer computador com o XAMPP.
Ligue o Apache e abra a Mini Loja
Faça assim:
- Abra o XAMPP Control Panel e clique em Start na linha do Apache.
- Abra a pasta
C:\xampp\htdocs\mini-lojano VS Code. Não tem a pasta? Crie e copie os arquivos da versão 4 da aula 12. - Tenha à mão duas fotos pequenas de componentes (baixe da internet ou tire com o celular).
A foto vai para a pasta, e o nome vai para o banco
O formulário ganha o campo da foto. O garçom guarda o arquivo na pasta uploads, e a lista mostra a foto ao lado do produto.
Faça assim:
- Troque os três arquivos
.php. - Recarregue
http://localhost/mini-loja/cadastro.php. A lista aparece com "📦 sem foto": a colunaimagemnasceu, vazia. - Cadastre um produto novo com foto. Ela aparece na lista, e a pasta
uploadsnasce sozinha.
Versão 1, o que mudou
banco.php
PRAGMA table_info(produtos)pergunta ao SQLite quais colunas a tabela tem.- Não tem
imagem? OALTER TABLE produtos ADD COLUMN imagem TEXTacrescenta. Na próxima vez ela já existe, e nada acontece. inserirProduto()agora grava também o nome da foto. OSELECTpassa a trazer a colunaimagem.
cadastro.php
$_FILES['imagem']['error'] === UPLOAD_ERR_OK: chegou um arquivo inteiro?mkdircria a pastauploadsna primeira vez.move_uploaded_filetira o arquivo do lugar provisório e põe na pasta, com o nome que veio. Guarde essa frase: é aí que mora o perigo.
tela.php
enctype="multipart/form-data"faz o arquivo viajar junto com o formulário.<input type="file" accept="image/*">abre a escolha de arquivo, sugerindo imagens.- Tem foto?
<img src="uploads/...">. Não tem? "📦 sem foto".
O bilhete disfarçado de foto
A versão 1 funciona, mas pendura qualquer coisa. Faça o teste, só no seu computador.
Faça assim:
- No VS Code, crie um arquivo
foto-teste.phpfora da pasta da loja (na Área de Trabalho, por exemplo), com esta linha:
1<?php echo "Este arquivo virou um programa no servidor!"; ?>
- Cadastre um produto e, no campo da foto, escolha o
foto-teste.php(troque o filtro da janela para "Todos os arquivos"). - Abra
http://localhost/mini-loja/uploads/foto-teste.php.
Apareceu a frase? Então o servidor executou o arquivo que você mandou. Um atacante, no lugar da frase, poria ordens para ler o banco, apagar tudo ou tomar o servidor. O garçom pendurou um bilhete no cardápio, e o bilhete começou a mandar na cozinha.
Terminou o teste? Apague o foto-teste.php da pasta uploads e exclua o produto dele. A versão 2 fecha essa porta.
Só foto de verdade, pequena e com nome novo
O cadastro.php ganha duas funções: uma confere a foto, a outra guarda com um nome inventado. Foto recusada volta com o aviso, e o que a pessoa digitou continua no formulário.
Faça assim:
- Troque o
cadastro.phpe atela.php. Obanco.phpfica igual. - Tente de novo com o
foto-teste.php: agora aparece "Foto recusada". - Cadastre um produto com uma foto de verdade e olhe a pasta
uploads: o nome dela virou uma sopa de letras e números.
Versão 2, o que mudou
cadastro.php
conferirImagem()devolve''quando está tudo certo, ou a frase do problema. As perguntas vão na ordem: cabe? chegou inteiro? está vazio? é foto?UPLOAD_ERR_INI_SIZEé o aviso de que o arquivo passou do limite dophp.ini, antes mesmo de chegar à nossa conta dos 2 MB.getimagesize()abre o arquivo. Se não for imagem, devolvefalse. Se for, a posição[2]diz o tipo de verdade. O nome do arquivo nem é olhado.guardarImagem()inventa o nome combin2hex(random_bytes(8)): 16 letras e números. A extensão vem do tipo de verdade, nunca do nome que chegou.- Deu problema? O controle não grava, não redireciona e manda para a tela o
$erroe o que já tinha sido digitado.
tela.php
- O aviso
$erroaparece acima do formulário, em vermelho. - O
acceptsugere só JPG, PNG e WEBP. É só uma ajuda para a pessoa: quem confere de verdade é o PHP.
Funcionou? Envie para o GitHub: Add file › Upload files, arraste os três arquivos .php, escreva Versão 2: upload com a foto conferida e clique em Commit changes.
Editar troca a foto; excluir apaga a foto junto
Sem esta versão, a pasta uploads vira um depósito de fotos órfãs, de produtos que nem existem mais.
Faça assim:
- Troque os três arquivos
.php. - Clique em Editar num produto com foto: aparece a "Foto atual". Escolha outra e salve: a antiga some da pasta.
- Edite de novo, sem escolher foto: a foto continua a mesma.
- Exclua um produto com foto e confira: a foto dele saiu da pasta
uploads.
Versão 3, o que mudou
banco.php
atualizarProduto()recebe também a foto:UPDATE ... SET nome, preco, imagem WHERE id.
cadastro.php
apagarImagem()tira uma foto da pasta com ounlink. Obasenamegarante que o nome não sai da pastauploads.- No Excluir, o controle busca o produto primeiro, apaga a foto e só depois apaga o produto.
- No Editar: não veio foto nova? Fica a de antes. Veio? A antiga sai da pasta e a nova entra no banco.
tela.php
- Editando um produto com foto, aparece a "Foto atual", e o campo vira "Trocar a foto (só se quiser)".
Funcionou? Envie para o GitHub: Add file › Upload files, arraste os três arquivos .php, escreva Versão 3: trocar e apagar a foto e clique em Commit changes.
O que vai e o que não vai para o GitHub
- Vai: os arquivos
.phpe oindex.html. - Não vai: o
mini-loja.sqlitee a pastauploads. São os dados da sua loja: ficam só no computador. - Apague da pasta
uploadsqualquer.phpque tenha sobrado do teste da versão 1. - No fim da aula, clique em Stop no Apache.
Cadastrar produto com foto
Caso fictício, da própria Mini Loja.
Ator: Gerente da Mini Loja
Objetivo: Mostrar a foto de cada componente, sem abrir a porta da loja para ataques.
Fluxo principal
- Preenche o nome e o preço e escolhe a foto do produto.
- O sistema confere a foto: inteira, até 2 MB, JPG, PNG ou WEBP de verdade.
- O sistema guarda a foto na pasta
uploadscom um nome novo e anota esse nome no banco. - A lista mostra o produto com a foto.
E se...
- A foto tem 8 MB? O sistema recusa, avisa e mantém o que foi digitado.
- Alguém manda um
.phprenomeado para.jpg? Ogetimagesizeolha dentro, vê que não é imagem, e o arquivo nem entra. - A gerente troca a foto? A antiga sai da pasta; a nova entra no lugar.
- O produto é excluído? A foto vai embora junto.
Para pensar
- Por que guardar só o nome da foto no banco, e não a foto inteira?
- O
acceptdo formulário já filtra as imagens. Por que o PHP precisa conferir de novo? - Duas pessoas mandam fotos chamadas
sensor.jpg. O que acontecia na versão 1? E na 2?
A foto do produto
Vá marcando os passos: o que você marcar fica salvo neste navegador e, se você entrar com o e-mail da faculdade (botão Entrar, no topo), na sua conta.
A vitrine da loja
Arte
Que tal fotografar componentes de verdade, até peças de sucata eletrônica? Fundo liso, luz de janela e o celular paradinho já fazem uma vitrine bonita.
Matemática
2 MB são 2 × 1024 × 1024 = 2.097.152 bytes. E o nome novo tem 16 algarismos hexadecimais: são 1616, mais de 18 quintilhões de nomes possíveis. Adivinhar o nome de uma foto é quase impossível.
Eletrônica
Um bom projeto com ESP32 também desconfia do que chega: leitura de sensor absurda (100 °C numa sala) é descartada antes de virar decisão. Conferir a entrada vale para fotos e para fios.
Para estudar e praticar
Manual do PHP: upload de arquivos
O $_FILES, os códigos de erro e o move_uploaded_file, em português.
getimagesize
A função que abre o arquivo e diz se é imagem, e de que tipo.
OWASP: upload seguro (em inglês)
A lista de cuidados com upload que os profissionais de segurança usam.
O repositório mini-loja no GitHub
Pelo menos com a versão 2 (a foto conferida), enviada por upload.