Guia 03 / 4
Oficina de PDO · À table !
Ligar o PHP à base de dados MySQL do curso anterior: pesquisar as receitas, consultar uma ficha e guardar uma nova receita que continue disponível após recarregar.
Reproduzir uma realização funcional, testá-la e depois resolver um exercício sem copiar.
01 · Montar o blogue ligado
Os cinco ficheiros completos abaixo substituem a leitura de tabelas pela leitura do MySQL.
Etapa 1 · Verificar o esquema e as pastas
Utilizar exatamente o schema.sql do curso de MySQL: nomes das tabelas e das colunas, categorias e dados iniciais. Criar db.php e substituir depois index.php e recette.php pelas suas versões PDO. Acrescentar ajouter.php e conservar functions.php.
Exemplo
mini-blog/
├── public/
│ ├── index.php # version PDO
│ ├── recette.php # version PDO
│ ├── ajouter.php # nouveau formulaire
│ └── style.css # copie du cours CSS
├── includes/
│ ├── functions.php
│ └── db.php
└── database/
└── schema.sql # cours MySQL
recettes.php e proposer.php da etapa anterior já não são utilizados por estas novas páginas. Não carregar o script de filtragem do DOM do curso de JavaScript nestas páginas PHP.
Etapa 2 · Configurar e apresentar a lista
Criar a conta MySQL limitada e definir as variáveis de ambiente como nos essenciais. Lançar o PHP e abrir depois a lista. Observar o resultado da junção e testar o formulário GET.
Exemplo
http://127.0.0.1:8000/index.php
http://127.0.0.1:8000/index.php?q=soupe
Esperado na base de dados inicial: três cartões sem filtro, um cartão para soupe, cada um com o nome da sua categoria.
Etapa 3 · Testar uma ficha
Abrir recette.php?id=1 e tentar depois um identificador inexistente e um texto. O identificador válido é ligado à consulta preparada antes da leitura.
Exemplo
id=1 → fiche de soupe
id=999999 → 404 si absent
id=abc → 400
id[]=1 → 400
Nenhuma mensagem técnica SQL deve aparecer na página.
Etapa 4 · Acrescentar uma compota completa
Abrir ajouter.php. Preencher todos os campos, escolher Dessert e enviar. A página redireciona para a nova ficha. Voltar à lista, recarregar e encontrar a receita.
Exemplo
Titre : Compote de pommes
Durée : 15
Personnes : 2
Catégorie : Dessert
Ingrédients : 2 pommes [nouvelle ligne] Un peu d’eau
Préparation : Couper les pommes. [nouvelle ligne] Cuire puis écraser.
Esperado: quatro receitas se a base de dados era a inicial. A nova receita permanece na base de dados após parar e reiniciar o servidor PHP.
02 · Verificar as fronteiras e prolongar
Testar depois de ter superado o percurso normal.
Verificação · Recusar os dados incoerentes
Retirar temporariamente os limites HTML nas ferramentas do navegador. Enviar duração -1, porções 0, título vazio ou uma categoria inexistente. Os erros do servidor devem impedir a inserção, mantendo os outros campos introduzidos.
Exemplo
Attendu :
- erreurs lisibles ;
- aucune nouvelle ligne ;
- formulaire de nouveau disponible.
A chave estrangeira é um segundo controlo se uma categoria desaparecer entre a validação e a escrita.
Verificação · Manter os carateres especiais como dados
Criar uma receita cujo título contenha um apóstrofo e sinais de menor/maior. Encontrá-la e verificar que o título é apresentado literalmente.
Exemplo
Titre : Soupe d'automne <maison>
Attendu : insertion réussie et chevrons visibles dans la fiche.
Os valores são ligados para o SQL e escapados para o HTML. São dois tratamentos distintos.
Verificação · Controlar o token e o recarregamento
No seu próprio formulário, modificar o valor do campo csrf com as ferramentas do navegador e enviar. Recarregar o formulário para tentar de novo normalmente. Depois de uma adição bem-sucedida, atualizar a ficha.
Exemplo
Jeton modifié → réponse 403, aucune insertion.
Actualisation après redirection → lecture de la fiche, aucune nouvelle insertion.
O campo csrf está oculto pelo seu tipo HTML; oculto não significa inviolável. O servidor deve compará-lo com o token conservado na sessão.
Exercício · Uma página de receitas rápidas
Numa cópia de index.php, acrescentar um limite fixo de 20 minutos ao SQL. Preservar a pesquisa facultativa por título e utilizar um parâmetro inteiro para esse limite.
Exemplo
Attendu avant les ajouts : soupe et salade. Après ajout de la compote : trois recettes rapides.
Solução · Uma estrutura SQL fixa e dois valores ligados
Substituir a construção e a execução da consulta da lista por este tratamento. Cada parâmetro com nome aparece uma única vez no SQL.
Exemplo
$sql = 'SELECT r.id, r.titre, r.duree_minutes, r.portions, c.nom AS categorie
FROM recettes AS r JOIN categories AS c ON c.id = r.categorie_id
WHERE r.duree_minutes <= :limite';
if ($q !== '') { $sql .= ' AND r.titre LIKE :recherche'; }
$sql .= ' ORDER BY r.duree_minutes, r.id';
$requete = $pdo->prepare($sql);
$requete->bindValue(':limite', 20, PDO::PARAM_INT);
if ($q !== '') { $requete->bindValue(':recherche', '%' . $q . '%', PDO::PARAM_STR); }
$requete->execute();
$recettes = $requete->fetchAll();
Manter este tratamento no try/catch da página. É possível concatenar fragmentos SQL fixos; os valores externos permanecem ligados.