Stela

Stela PHP Aulas Aula 14

Fac Senac DF Aulas 14 e 15 Laboratório de práticas Upload

Mini Loja: a foto do produto

O produto ganha foto, e o garçom aprende a conferir tudo o que entra na loja.

Objetivo do dia

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.

Antes da aula

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.

Como conta ponto

Atividade no laboratório, enviada ao GitHub por upload.

P1 · o problema

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.

O que muda hoje
VersãoO que aconteceO garçom...
1a foto entra na lojapendura qualquer coisa (e você vai ver o perigo)
2a foto é conferida antes de entrarolha dentro do arquivo e dá um nome novo
3editar troca a foto; excluir apaga a foto juntonão deixa foto esquecida na pasta
C1–C3 · conceitos

Três ideias, e só

C1

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
C2

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
C3

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:

  1. Chegou inteiro? (error)
  2. Cabe? Até 2 MB (size).
  3. É foto de verdade? O getimagesize abre o arquivo e olha dentro. Só passam JPG, PNG e WEBP.
  4. 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';
I1 · experimente

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.

T1 · tutorial

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.

Antes de começar

Ligue o Apache e abra a Mini Loja

Faça assim:

  1. Abra o XAMPP Control Panel e clique em Start na linha do Apache.
  2. Abra a pasta C:\xampp\htdocs\mini-loja no VS Code. Não tem a pasta? Crie e copie os arquivos da versão 4 da aula 12.
  3. Tenha à mão duas fotos pequenas de componentes (baixe da internet ou tire com o celular).
Versão 1 · a foto entra

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:

  1. Troque os três arquivos .php.
  2. Recarregue http://localhost/mini-loja/cadastro.php. A lista aparece com "📦 sem foto": a coluna imagem nasceu, vazia.
  3. Cadastre um produto novo com foto. Ela aparece na lista, e a pasta uploads nasce sozinha.
entenda o código

Versão 1, o que mudou

banco.php

  1. PRAGMA table_info(produtos) pergunta ao SQLite quais colunas a tabela tem.
  2. Não tem imagem? O ALTER TABLE produtos ADD COLUMN imagem TEXT acrescenta. Na próxima vez ela já existe, e nada acontece.
  3. inserirProduto() agora grava também o nome da foto. O SELECT passa a trazer a coluna imagem.

cadastro.php

  1. $_FILES['imagem']['error'] === UPLOAD_ERR_OK: chegou um arquivo inteiro?
  2. mkdir cria a pasta uploads na primeira vez.
  3. move_uploaded_file tira 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

  1. enctype="multipart/form-data" faz o arquivo viajar junto com o formulário.
  2. <input type="file" accept="image/*"> abre a escolha de arquivo, sugerindo imagens.
  3. Tem foto? <img src="uploads/...">. Não tem? "📦 sem foto".
Pausa aqui · o ataque

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:

  1. No VS Code, crie um arquivo foto-teste.php fora da pasta da loja (na Área de Trabalho, por exemplo), com esta linha:
1<?php echo "Este arquivo virou um programa no servidor!"; ?>
  1. Cadastre um produto e, no campo da foto, escolha o foto-teste.php (troque o filtro da janela para "Todos os arquivos").
  2. 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.

Versão 2 · o garçom confere

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:

  1. Troque o cadastro.php e a tela.php. O banco.php fica igual.
  2. Tente de novo com o foto-teste.php: agora aparece "Foto recusada".
  3. Cadastre um produto com uma foto de verdade e olhe a pasta uploads: o nome dela virou uma sopa de letras e números.
entenda o código

Versão 2, o que mudou

cadastro.php

  1. conferirImagem() devolve '' quando está tudo certo, ou a frase do problema. As perguntas vão na ordem: cabe? chegou inteiro? está vazio? é foto?
  2. UPLOAD_ERR_INI_SIZE é o aviso de que o arquivo passou do limite do php.ini, antes mesmo de chegar à nossa conta dos 2 MB.
  3. getimagesize() abre o arquivo. Se não for imagem, devolve false. Se for, a posição [2] diz o tipo de verdade. O nome do arquivo nem é olhado.
  4. guardarImagem() inventa o nome com bin2hex(random_bytes(8)): 16 letras e números. A extensão vem do tipo de verdade, nunca do nome que chegou.
  5. Deu problema? O controle não grava, não redireciona e manda para a tela o $erro e o que já tinha sido digitado.

tela.php

  1. O aviso $erro aparece acima do formulário, em vermelho.
  2. O accept sugere 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.

Versão 3 · trocar e apagar

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:

  1. Troque os três arquivos .php.
  2. Clique em Editar num produto com foto: aparece a "Foto atual". Escolha outra e salve: a antiga some da pasta.
  3. Edite de novo, sem escolher foto: a foto continua a mesma.
  4. Exclua um produto com foto e confira: a foto dele saiu da pasta uploads.
entenda o código

Versão 3, o que mudou

banco.php

  1. atualizarProduto() recebe também a foto: UPDATE ... SET nome, preco, imagem WHERE id.

cadastro.php

  1. apagarImagem() tira uma foto da pasta com o unlink. O basename garante que o nome não sai da pasta uploads.
  2. No Excluir, o controle busca o produto primeiro, apaga a foto e só depois apaga o produto.
  3. 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

  1. 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.

Para fechar

O que vai e o que não vai para o GitHub

  1. Vai: os arquivos .php e o index.html.
  2. Não vai: o mini-loja.sqlite e a pasta uploads. São os dados da sua loja: ficam só no computador.
  3. Apague da pasta uploads qualquer .php que tenha sobrado do teste da versão 1.
  4. No fim da aula, clique em Stop no Apache.
CU1 · caso de uso

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

  1. Preenche o nome e o preço e escolhe a foto do produto.
  2. O sistema confere a foto: inteira, até 2 MB, JPG, PNG ou WEBP de verdade.
  3. O sistema guarda a foto na pasta uploads com um nome novo e anota esse nome no banco.
  4. 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 .php renomeado para .jpg? O getimagesize olha 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

  1. Por que guardar só o nome da foto no banco, e não a foto inteira?
  2. O accept do formulário já filtra as imagens. Por que o PHP precisa conferir de novo?
  3. Duas pessoas mandam fotos chamadas sensor.jpg. O que acontecia na versão 1? E na 2?
A1 · atividade

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.

0 de 8
S1 · conexão STEAM

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.

J1 · materiais

Para estudar e praticar

E1 · entrega

O repositório mini-loja no GitHub

Pelo menos com a versão 2 (a foto conferida), enviada por upload.