Stela

Stela PHP Aulas Aula 9

Fac Senac DF Aula 9 Projeto Cadastro de Clientes, parte I

Onde vai parar o que o cliente digita?

Formulário com validação e o primeiro banco de dados do Cadastro de Clientes.

Objetivo do dia

Receber e validar os dados de um formulário com PHP e guardar cada cliente num banco de dados.

Antes da aula

Deixar o PHP rodando (XAMPP ou o servidor embutido do Lab-PHP) e revisar o $_POST.

Como conta ponto

Exercícios no laboratório, com commit no GitHub.

P1 · o problema

O cliente que sumiu

Você preenche o formulário, o PHP responde "Cadastro feito!" e, quando a página recarrega, o cliente sumiu. Não é bug: variável só vive enquanto a página está sendo montada.

Para o Cadastro de Clientes lembrar de alguém amanhã, os dados precisam de um lugar que não esquece. Hoje vocês fazem as duas coisas: um formulário caprichado, que confere tudo antes de aceitar, e o primeiro banco de dados do projeto.

C1–C8 · conceitos

Do formulário ao banco, em oito peças

C1

Cliente e servidor: quem pede e quem responde

Quando você digita o endereço de um site, o seu navegador (o cliente) manda um pedido pela internet. Do outro lado, um computador sempre ligado (o servidor) recebe o pedido e devolve a página. É uma conversa: pedido e resposta.

Todo pedido vai de um jeito, o método. Pense no correio: o GET é um cartão-postal (o pedido vai escrito por fora e todo mundo lê) e o POST é uma carta no envelope (os dados vão dentro).

Por que o PHP não roda no GitHub? O GitHub Pages só entrega páginas prontas. Para o PHP trabalhar, precisa de um servidor com PHP: na aula, é o seu próprio computador, com php -S localhost:8000.

Repare na barra de endereço

localhost:8000/cadastro.php?busca=ana

GET: o pedido aparece no endereço. Dá para copiar, salvar e mandar para alguém.

localhost:8000/cadastro.php

POST: nome e e-mail foram no envelope. O endereço não mostra nada.

Cena 1 · GET: pedir para ver (o cartão-postal)

cliente Você no navegador Quer ver o site da Stela e digita o endereço.
pedido · GET "Quero ver o site da Stela." O pedido vai escrito por fora, no endereço, e todo mundo lê: maristelaoliveira.github.io/prog-web-php/
resposta "Aqui está!" O servidor manda a página, e o navegador mostra o site.
servidor O servidor do GitHub Um computador sempre ligado, que guarda o site e entrega a página para quem pedir.

Cena 2 · POST: entregar dados (a carta no envelope)

cliente Você no formulário Preenche nome e e-mail e clica em Cadastrar.
pedido · POST "Toma, cadastra esta cliente." Nome e e-mail vão dentro do envelope. Por fora, só o endereço: localhost:8000/cadastro.php
resposta "Recebido!" O servidor abre o envelope, lê os dados e responde com uma página nova.
servidor Um servidor com PHP Na aula, é o seu computador, ligado com php -S localhost:8000.
O cliente pede, o servidor responde. O GET pede para ver; o POST entrega dados para o servidor.
GET ou POST?
GETPOST
Pensa assimCartão-postal: o que está escrito fica à vista.Carta no envelope: os dados vão dentro.
Onde vão os dadosNo endereço: ?busca=anaDentro do pedido, fora do endereço.
Dá para salvar o link?Sim: o pedido inteiro está no endereço.Não. Recarregou a página? O navegador pergunta se quer reenviar o formulário.
Use paraVer páginas, buscar e filtrar.Cadastrar, alterar e enviar senha.
No PHP$_GET['busca']$_POST['nome']

Envelope não é cofre: o POST só tira os dados do endereço. Quem protege de verdade no caminho é o https, o cadeado do navegador.

Toda resposta do servidor vem com um número, o código de resposta: é o carimbo do correio dizendo como foi a entrega. O navegador lê esse carimbo antes de mostrar a página.

E aquele número na resposta?
CódigoQuer dizerNo correio
200Deu certo: aqui está a página. É a resposta de quase todo pedido.Carta entregue.
404Não encontrei essa página. O endereço ou o nome do arquivo está errado.Endereço que não existe.
500Deu erro dentro do servidor: o PHP quebrou no meio do caminho.O carteiro tropeçou.

Por que eu nunca vejo o 500? No seu computador, o PHP prefere escrever a mensagem de erro na própria página, para você achar e consertar. Num site publicado, os erros ficam escondidos do visitante, e aí aparece o 500. Quer ver os códigos de verdade? Aperte F12, abra a aba Rede (Network) e recarregue a página: a coluna Status mostra o código de cada arquivo.

C2

O formulário certo

O method="post" manda os dados escondidos no corpo da requisição, e não no endereço. Cada campo precisa de um name: é por ele que o PHP encontra o valor. O id é do <label> e do CSS.

Pegadinha clássica: campo sem name não chega no PHP. Nem dá erro: simplesmente some.

1<form method="post">2  <label for="nome">Nome</label>3  <input id="nome" name="nome">45  <label for="email">E-mail</label>6  <input id="email" name="email" type="email">78  <label for="telefone">Telefone</label>9  <input id="telefone" name="telefone">1011  <button type="submit">Cadastrar</button>12</form>
C3

Receber e limpar

O PHP só processa quando o formulário foi enviado: é isso que o REQUEST_METHOD confere. Tudo chega dentro de $_POST, sempre como texto.

O trim() tira os espaços do começo e do fim, para ninguém passar na validação digitando só espaço.

1if ($_SERVER['REQUEST_METHOD'] === 'POST') {2    // ?? '' evita erro se o campo não vier3    $nome = trim($_POST['nome'] ?? '');4    $email = trim($_POST['email'] ?? '');5    $telefone = trim($_POST['telefone'] ?? '');6}
C4

Validar antes de usar

Dado de usuário é suspeito até prova em contrário. A função devolve uma lista de erros: lista vazia quer dizer que está tudo certo.

O filter_var() com FILTER_VALIDATE_EMAIL já sabe o formato de um e-mail. Não precisa inventar a regra.

1// recebe e confere os dados do formulário2function validarCliente(string $nome, string $email): array3{4    $erros = [];5    if (strlen($nome) < 3) {6        $erros[] = 'O nome precisa de pelo menos 3 letras.';7    }8    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {9        $erros[] = 'Digite um e-mail válido.';10    }11    return $erros;12}
C5

Errou? Não apague o que foi digitado

Quando der erro, a página volta com os campos preenchidos e o aviso na tela. Ninguém merece digitar tudo de novo.

Segurança: o htmlspecialchars() mostra o texto como texto. Sem ele, quem digitar <b> ou um <script> no nome muda a sua página.

1<input id="nome" name="nome"2       value="<?= htmlspecialchars($nome) ?>">34<?php foreach ($erros as $erro): ?>5  <p class="erro"><?= htmlspecialchars($erro) ?></p>6<?php endforeach; ?>
C6

Banco de dados: a memória que não esquece

Variável vive só enquanto a página está sendo montada. O banco guarda os dados num arquivo, e eles continuam lá amanhã.

Uma tabela é uma planilha com regras: cada coluna é um campo e cada linha é um cliente. O id numera as linhas sozinho, e o UNIQUE não deixa repetir e-mail.

Hoje a gente usa o SQLite, que já vem com o PHP: o banco é um arquivo, o clientes.sqlite. Mais à frente vem o MySQL, e o resto do código fica igual.

1// abre (ou cria) o arquivo do banco e a tabela de clientes2$pdo = new PDO('sqlite:' . __DIR__ . '/clientes.sqlite');3$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);45$pdo->exec('CREATE TABLE IF NOT EXISTS clientes (6    id INTEGER PRIMARY KEY AUTOINCREMENT,7    nome TEXT NOT NULL,8    email TEXT NOT NULL UNIQUE,9    telefone TEXT10)');1112// no MySQL do XAMPP, só a conexão muda:13// new PDO('mysql:host=localhost;dbname=loja;charset=utf8mb4', 'root', '');
C7

Gravar e listar com segurança

O prepare() monta o comando com marcadores (:nome, :email) e o execute() encaixa os valores. Assim o banco nunca confunde o que o usuário digitou com um comando.

Nunca cole $_POST direto dentro do SQL. Isso abre a porta para o ataque de SQL injection.

1$sql = 'INSERT INTO clientes (nome, email, telefone)2        VALUES (:nome, :email, :telefone)';3$stmt = $pdo->prepare($sql);4$stmt->execute([5    ':nome' => $nome,6    ':email' => $email,7    ':telefone' => $telefone,8]);910// e para listar:11$sql = 'SELECT nome, email FROM clientes ORDER BY nome';12$clientes = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC);
C8

Cada arquivo com seu trabalho: o MVC

Num restaurante, o garçom não cozinha e a cozinheira não vai até a mesa. Cada um faz a sua parte, e por isso a casa funciona até lotada. No código é igual, e esse jeito de organizar tem nome: MVC, de Model, View, Controller (Modelo, Visão e Controle).

Modelo (clientes.php): o único que fala com o banco. Os comandos do C6 e do C7 moram lá, dentro de funções. Visão (tela-cadastro.php): só o HTML da página. Controle (cadastro.php): recebe o pedido, chama o modelo e mostra a visão.

Regra de ouro: SQL só no modelo, HTML só na visão. Achou um SELECT no meio do HTML? Alguém entrou na cozinha errada.

1// cadastro.php (o controle): só coordena2$erros = validarCliente($nome, $email);34if (!$erros) {5    inserirCliente($nome, $email);   // o modelo grava6}78$clientes = listarClientes();        // o modelo busca910require __DIR__ . '/tela-cadastro.php';  // a visão mostra
  1. 1 · quem pede O cliente na mesa navegador Preenche o formulário e faz o pedido.
  2. 2 · Controle (C) O garçom cadastro.php Anota o pedido, confere com o validar.php e leva para a cozinha.
  3. 3 · Modelo (M) A cozinha clientes.php A única que mexe na despensa: o banco (banco.php e clientes.sqlite).
  4. 4 · Visão (V) O prato servido tela-cadastro.php A página pronta, que volta para o navegador. Só mostra, não cozinha.
O caminho de um cadastro. O garçom não cozinha e a cozinha não vai até a mesa: cada arquivo com seu trabalho.

Para rodar: na pasta do projeto, abra o terminal e digite php -S localhost:8000. Depois abra http://localhost:8000/cadastro.php. No XAMPP, coloque a pasta dentro de htdocs.

T1 · tutorial

Mão na massa: o Cadastro de Clientes em 5 versões

Cada versão é o projeto inteiro, pronto para copiar. Faça uma de cada vez: copie, rode, teste, entenda o que mudou e só depois passe para a próxima. Aprender programação é isso: fazer, melhorar, acrescentar.

O combinado de hoje: na aula, as versões 1 a 3. As versões 4 e 5 são bônus, para casa ou para quem terminar antes. Sem pressa: a aula 10 começa revisando as duas juntos.

Antes de começar

Prepare a pasta e ligue o servidor

  1. Crie uma pasta chamada cadastro-clientes dentro do seu repositório.
  2. Abra a pasta no VS Code: Arquivo › Abrir pasta.
  3. Abra o terminal do VS Code (Terminal › Novo terminal) e ligue o servidor do PHP: php -S localhost:8000. No laboratório, use o PHP do XAMPP: C:\xampp\php\php.exe -S localhost:8000.
  4. No navegador, abra http://localhost:8000/cadastro.php.

Dica: deixe o servidor ligado o tempo todo. Mudou o código? Salve (Ctrl + S) e recarregue o navegador (F5). Para desligar, Ctrl + C no terminal.

Como copiar: clique na aba do arquivo, depois em Copiar. No VS Code, apague tudo o que tinha no arquivo (Ctrl + A e Delete), cole (Ctrl + V) e salve. A etiqueta de cada aba avisa: novo (crie o arquivo), mudou (troque o conteúdo todo) ou igual (não precisa mexer).

Versão 1

O formulário responde

Um arquivo só: o mesmo cadastro.php mostra o formulário e, quando ele é enviado, responde com o nome.

Faça assim:

  1. Crie o arquivo cadastro.php, cole o código e salve.
  2. Abra http://localhost:8000/cadastro.php no navegador.

Teste:

  1. Envie o formulário com o seu nome.
  2. Envie o formulário vazio. O que aparece? Por quê?
  3. No navegador, clique com o botão direito e escolha Exibir código-fonte. Procure o PHP: ele não está lá.
Agora é com você:
  • Acrescente o campo E-mail (<label> e <input name="email">) e mostre o e-mail na mensagem.
  • Troque o texto do botão de "Enviar" para "Cadastrar".
  • Se o nome vier vazio, mostre "Escreva o seu nome" em vez da saudação.

Funcionou? Guarde e envie para o GitHub, um comando de cada vez:

1# 📦 1. põe na caixa2git add .3# 🏷️ 2. fecha e etiqueta4git commit -m "Versão 1: o formulário responde"5# 🚚 3. envia6git push

O git push reclamou? Se aparecer rejected, rode git pull e depois git push de novo. Se aparecer no upstream branch, rode uma vez git push -u origin main.

Versão 2

Valida e avisa

Agora o PHP confere os dados antes de aceitar. Os erros aparecem na tela e o que foi digitado continua nos campos.

Faça assim:

  1. Crie o arquivo validar.php e cole o código.
  2. Troque todo o conteúdo do cadastro.php pelo novo.
  3. Salve os dois e recarregue o navegador.

O que mudou: apareceu o arquivo validar.php, com a função que confere os dados. O cadastro.php chama essa função com require_once, mostra os erros e mantém os valores com value.

Teste:

  1. Envie "Al" no nome e "semarroba" no e-mail. Repare que os campos continuam preenchidos.
  2. Envie dados certos e veja a mensagem de sucesso.
  3. Digite <b>Oi</b> no nome. O texto aparece como texto, sem negrito: é o htmlspecialchars() trabalhando.
Agora é com você:
  • Acrescente o campo Telefone, que pode ficar vazio (não entra na validação).
  • Crie a regra: o nome pode ter no máximo 60 letras.
  • Coloque o erro de cada campo logo abaixo do campo, e não no topo.

Funcionou? Guarde e envie para o GitHub, um comando de cada vez:

1# 📦 1. põe na caixa2git add .3# 🏷️ 2. fecha e etiqueta4git commit -m "Versão 2: validação com erros na tela"5# 🚚 3. envia6git push
Versão 3

Guarda no banco de dados

Chegou a hora do banco. Cada cliente vai para o arquivo clientes.sqlite e continua lá, mesmo se você fechar o navegador. E já do jeito certo: o SQL ganha um arquivo só dele, o modelo (veja o C8).

Faça assim:

  1. Crie o arquivo banco.php e cole o código. Ele abre o banco e, na primeira vez, cria o arquivo e a tabela sozinho: você não precisa criar nada antes.
  2. Crie o arquivo clientes.php (o modelo) e cole o código.
  3. Troque todo o conteúdo do cadastro.php pelo novo.
  4. Crie o arquivo .gitignore (com o ponto no começo) e cole o código.
  5. Salve tudo e recarregue o navegador. O arquivo clientes.sqlite aparece na pasta no primeiro acesso.

O que mudou: o banco.php tem a função conectar(). O clientes.php é o modelo, com as únicas funções que falam SQL: inserirCliente(), emailCadastrado() e listarClientes(). O cadastro.php não tem nenhum SQL: só chama essas funções, em passos numerados nos comentários. O .gitignore deixa o banco fora do GitHub. O validar.php não mudou.

Caminho de um cadastro: navegador cadastro.php validar.php clientes.php banco.php clientes.sqlite

Teste:

  1. Cadastre dois clientes. Feche o navegador, abra de novo: eles continuam lá.
  2. Tente cadastrar de novo um e-mail que já existe.
  3. Procure SELECT ou INSERT no cadastro.php: não tem. Estão todos no clientes.php.
Agora é com você:
  • Mostre o total de clientes no título da lista, com count($clientes) (no cadastro.php, na parte do HTML).
  • No clientes.php, troque para ORDER BY id DESC: os mais novos aparecem primeiro. Repare que o cadastro.php nem ficou sabendo.
  • Acrescente a coluna Cidade, um arquivo de cada vez: a coluna na tabela (banco.php; depois apague o clientes.sqlite para a tabela nascer de novo), o INSERT e o SELECT (clientes.php) e o campo no formulário (cadastro.php).

Funcionou? Guarde e envie para o GitHub, um comando de cada vez:

1# 📦 1. põe na caixa2git add .3# 🏷️ 2. fecha e etiqueta4git commit -m "Versão 3: clientes guardados no SQLite, com modelo"5# 🚚 3. envia6git push
Bônus · para casa

Chegou até aqui? Missão de hoje cumprida, filhote! Seu cadastro já guarda clientes num banco de verdade e com o SQL no lugar certo. Faça o git push e respire. As versões 4 e 5 são para casa ou para quem terminou antes, e a aula 10 começa revisando as duas juntos.

Versão 4 · bônus

Cada arquivo com seu trabalho

O cadastro.php ainda faz dois trabalhos: controla e mostra a página. Agora o HTML vai para um arquivo só dele, a visão, e o projeto fica no MVC completo. A página continua igualzinha: mudar a organização sem mudar o resultado tem nome, refatorar.

Faça assim:

  1. Crie o arquivo tela-cadastro.php (a visão) e cole o código.
  2. Troque todo o conteúdo do cadastro.php pelo novo: agora ele não tem HTML nenhum.
  3. Salve os dois e recarregue o navegador. Tudo funciona como antes.

O que mudou: apareceu o tela-cadastro.php, com todo o HTML que estava no cadastro.php. O cadastro.php ficou só com o PHP e termina chamando a tela com require. As variáveis que ele criou ($nome, $erros, $clientes...) continuam valendo na tela, porque o require cola o arquivo ali. Os outros arquivos não mudaram.

Caminho de um cadastro: navegador cadastro.php validar.php clientes.php banco.php clientes.sqlite de volta: cadastro.php tela-cadastro.php navegador

Quem faz o quê na versão 4
ArquivoPapelO que faz
cadastro.phpControle
o garçom
Recebe o formulário, chama as funções e mostra a tela
validar.phpajuda o controle
o bloquinho do garçom
Confere nome e e-mail
clientes.phpModelo
a cozinha
Todo o SQL: grava, confere e lista
banco.phpajuda o modelo
a porta da despensa
Abre o banco e cria a tabela
tela-cadastro.phpVisão
o prato servido
Só o HTML da página

Teste:

  1. Cadastre um cliente e tente um e-mail repetido: tudo igual à versão 3.
  2. Abra direto http://localhost:8000/tela-cadastro.php: aparecem avisos (Warning) de variáveis que não existem. A visão sozinha não sabe de nada. Entre sempre pelo controle, o cadastro.php.
  3. Procure HTML no cadastro.php e SQL no tela-cadastro.php: não tem nenhum dos dois.
Agora é com você:
  • Mude o título da página e a cor dos avisos mexendo só no tela-cadastro.php.
  • Crie no modelo (clientes.php) a função contarClientes(), com SELECT COUNT(*) FROM clientes. No controle, guarde o resultado numa variável e mostre "Temos X clientes" na visão.
  • Explique para um colega, com o garçom, a cozinha e o prato, o caminho de um cadastro.

Funcionou? Guarde e envie para o GitHub, um comando de cada vez:

1# 📦 1. põe na caixa2git add .3# 🏷️ 2. fecha e etiqueta4git commit -m "Versão 4: MVC, cada arquivo com seu trabalho"5# 🚚 3. envia6git push
Versão 5 · bônus

Busca e visual caprichado

O cadastro ganha busca e cara de sistema. Repare como cada mudança vai para o seu lugar: SQL no modelo, $_GET no controle, HTML e CSS na visão.

Faça assim:

  1. Troque todo o conteúdo do clientes.php, do cadastro.php e do tela-cadastro.php pelos novos.
  2. Crie o arquivo estilo.css e cole o código.
  3. Salve tudo e recarregue o navegador.

O que mudou: no modelo (clientes.php), a listarClientes() recebe um pedaço do nome e usa o LIKE do SQL, sempre com prepare(). No controle (cadastro.php), a busca chega pelo $_GET, porque ela fica no endereço: ?busca=ana. Na visão (tela-cadastro.php), entram o formulário de busca, o total de clientes e o link para o estilo.css. O banco.php e o validar.php não mudaram.

Teste:

  1. Cadastre uns quatro clientes e busque por um pedaço do nome.
  2. Repare no endereço da página depois da busca: o termo está lá. Copie o endereço e abra numa aba nova.
  3. Busque por uma letra que nenhum nome tem.
Agora é com você:
  • Quando a busca não achar ninguém, mostre "Nenhum cliente encontrado" (na visão).
  • Crie um link "Limpar busca", que volta para cadastro.php (na visão).
  • Já pensando na próxima aula: coloque um link "Editar" ao lado de cada cliente. O modelo vai precisar de duas funções novas, buscarCliente() e atualizarCliente(). A tela de edição vem no módulo 7 do curso.

Funcionou? Guarde e envie para o GitHub, um comando de cada vez:

1# 📦 1. põe na caixa2git add .3# 🏷️ 2. fecha e etiqueta4git commit -m "Versão 5: busca e visual"5# 🚚 3. envia6git push
CU1 · caso de uso

Cadastrar um cliente

Ator: Atendente da loja

Objetivo: Cadastrar um cliente novo e ver o nome dele na lista.

Fluxo principal

  1. O atendente preenche nome, e-mail e telefone.
  2. O sistema confere os dados.
  3. Grava o cliente no banco.
  4. Mostra a confirmação e a lista atualizada.

E se...

  • O nome é curto ou o e-mail é inválido: o sistema avisa e mantém o que foi digitado.
  • O e-mail já está cadastrado: o sistema avisa e não grava duas vezes.

Para pensar

  1. Em que passo entra cada arquivo: cadastro.php (controle), validar.php, clientes.php (modelo), banco.php e tela-cadastro.php (visão)?
  2. O que acontece com os clientes se você fechar o navegador? E se apagar o clientes.sqlite?
A1 · atividade

Cadastro de Clientes, parte I

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 10
S1 · conexão STEAM

Memória que não esquece

Eletrônica

Variável é como a memória RAM: some quando desliga. O banco é como o SSD: fica gravado. Num ESP32 é igual, e quem não salva na memória flash perde tudo quando a placa reinicia.

Matemática

Uma tabela é uma matriz: linhas vezes colunas. O id é a posição de cada linha, como o número de série de um componente.

Arte

O formulário é a vitrine do sistema. Rótulo claro, espaço entre os campos e erro escrito em português de gente fazem o cliente terminar o cadastro.

D1 · desafio extra

Terminou antes? Tem mais.

Coloque um campo de busca em cima da lista. Ele mostra só os clientes cujo nome contém o que foi digitado, com WHERE nome LIKE :busca e, claro, prepare(). Dica: o valor do marcador é '%' . $busca . '%'.

J1 · materiais

Para estudar e praticar

E1 · entrega

Commit da pasta cadastro-clientes

Até o fim da aula. Na próxima, a gente continua o Cadastro de Clientes a partir daqui.