Guia 01 / 4
Glossário de PDO
Dar sentido aos termos de PDO associando-os ao miniblogue de receitas.
Explicar as noções por palavras suas e reconhecê-las num exemplo.
01 · Situar-se antes de começar
Etapa 6/6 do projeto condutor «À table !», um miniblogue de receitas. Avance ao seu ritmo: ler, reproduzir, modificar e depois verificar.
O percurso e o resultado desta etapa
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. O mesmo conjunto de dados acompanha os seis cursos: Soupe de carottes (20 min), Salade de tomates (10 min), Tarte aux pommes (45 min).
Exemplo
01. HTML : structurer trois recettes dans une page sémantique.
02. CSS : rendre le blog lisible sur mobile et sur ordinateur.
03. JavaScript : filtrer les recettes sans recharger la page.
04. PHP : produire les pages depuis des tableaux et traiter un formulaire.
05. MySQL : conserver les recettes dans une base relationnelle.
06. PDO : lire et ajouter des recettes depuis PHP avec des requêtes préparées.
Cada curso tem quatro guias: glossário, essenciais, oficina e recursos. Os ficheiros completos encontram-se no final da oficina.
Pré-requisitos e ambiente
Ter terminado PHP e MySQL. Dispor da base de dados blog_recettes criada com o schema.sql do curso de MySQL, das três receitas de referência e do PHP 8.x com pdo_mysql e mbstring. Conservar functions.php do curso de PHP e style.css do curso de CSS. O servidor MySQL deve estar iniciado e acessível a partir do PHP. Esta oficina pratica-se no posto de trabalho local.
Exemplo
mini-blog/
index.html # HTML, CSS et JavaScript
style.css # ajouté à l’étape CSS
app.js # ajouté à l’étape JavaScript
public/ # pages PHP accessibles par HTTP
includes/ # fonctions, connexion et données PHP
database/ # scripts SQL
Criar esta pasta de trabalho separadamente dos ficheiros do curso Technipédia. Os caminhos dos exemplos são relativos a mini-blog/. Não substituir a página HTML desta plataforma.
O método: compreender, reproduzir, transformar
Ler uma ficha e depois digitar o respetivo exemplo. Explicar o que muda no ecrã. Alterar uma única coisa de cada vez e comparar com o resultado esperado. Guardar uma cópia da etapa anterior antes de continuar.
Exemplo
1. Je lis et je reformule.
2. Je reproduis dans mon mini-blog.
3. Je change une valeur ou une règle.
4. Je vérifie et j’explique le résultat.
Os excertos curtos ilustram uma noção; apenas os ficheiros anunciados como completos devem ser copiados tal como estão. Os fragmentos não devem ser concatenados num único ficheiro.
02 · Ligar o PHP ao motor SQL
O PDO é uma interface PHP de acesso a dados, e não uma linguagem nem uma base de dados suplementar.
PDO e controlador
O PDO propõe uma interface para comunicar com bases de dados. O controlador pdo_mysql permite falar com o MySQL. As consultas continuam escritas no dialeto SQL do servidor visado.
Exemplo
PHP → PDO → pilote pdo_mysql → serveur MySQL
MySQL → lignes → tableaux PHP → HTML
Mudar de controlador não torna automaticamente todo o SQL compatível com outro motor.
DSN
O DSN descreve o tipo de ligação, o anfitrião, a porta, o nome da base de dados e a codificação. A conta e a palavra-passe são transmitidas separadamente ao construtor.
Exemplo
$dsn = "mysql:host=127.0.0.1;port=3306;dbname=blog_recettes;charset=utf8mb4";
localhost pode utilizar um socket consoante a configuração; 127.0.0.1 designa aqui uma ligação TCP local.
Instância PDO e método
new PDO cria um objeto de ligação. Um método é uma ação desse objeto, chamada com ->, como prepare ou query.
Exemplo
$pdo = new PDO($dsn, $utilisateur, $motDePasse, $options);
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");
PDOStatement
Um PDOStatement representa uma consulta preparada ou o seu resultado. execute lança a execução; fetch e fetchAll leem depois as linhas.
Exemplo
$requete->execute(["id" => 1]);
$recette = $requete->fetch();
Parâmetro ligado
Um parâmetro é um espaço reservado para um valor externo, separado do texto SQL. :id é um parâmetro com nome. Não deve ser rodeado de apóstrofos na consulta.
Exemplo
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");
$requete->execute(["id" => 1]);
Um parâmetro representa um valor inteiro, e não um nome de coluna nem uma cláusula ORDER BY.
Injeção SQL
Uma injeção ocorre quando um valor externo modifica a estrutura da consulta. Separar o SQL e os parâmetros impede que esse valor seja interpretado como código SQL nos espaços reservados ligados.
Exemplo
// La valeur arrive séparément du SQL.
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE titre = :titre");
$requete->execute(["titre" => $titre]);
Evitar concatenar $_GET ou $_POST ao SQL. A validação continua a ser necessária para as regras de negócio.
03 · Compreender a escrita a partir de um formulário
O formulário passa por vários controlos antes do registo.
Exceção e try/catch
Com ERRMODE_EXCEPTION, o PDO assinala uma falha por uma exceção. try envolve a operação; catch interceta o problema para responder sem mostrar os detalhes da ligação.
Exemplo
try {
$requete->execute();
} catch (PDOException $erreur) {
http_response_code(500);
exit("Opération indisponible.");
}
Sessão e token CSRF
Uma sessão liga pedidos do mesmo navegador graças a um cookie. Um token aleatório conservado na sessão e enviado no formulário permite verificar que uma escrita provém do formulário esperado.
Exemplo
session_start();
$_SESSION['csrf'] = bin2hex(random_bytes(32));
A versão completa gera o token apenas se faltar e compara-o com hash_equals. Este token não substitui nem a autenticação nem as autorizações.
POST, redirecionamento e GET
Após um registo bem-sucedido em POST, o servidor responde com um redirecionamento 303 para a ficha em GET. Atualizar essa ficha não reenvia o formulário.
Exemplo
header('Location: recette.php?id=' . $nouvelId, true, 303);
exit;
Esta organização evita o reenvio devido à atualização da página final; não garante a ausência de duplicados em caso de duas submissões distintas.
Identificador acrescentado e persistência
lastInsertId recupera o identificador gerado nesta ligação. Depois de INSERT, os dados estão no MySQL e permanecem acessíveis às consultas seguintes.
Exemplo
$nouvelId = (int) $pdo->lastInsertId();
Não presumir que a nova receita terá o id 4: AUTO_INCREMENT pode ter lacunas.