PDO — As bases

Guia 01 / 4

Glossário de PDO

Dar sentido aos termos de PDO associando-os ao miniblogue de receitas.

Resultado esperado :

Explicar as noções por palavras suas e reconhecê-las num exemplo.

Leitura
0%

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

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.
A reter :

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.

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
A reter :

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.

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.
A reter :

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.

PHP → PDO → pilote pdo_mysql → serveur MySQL
MySQL → lignes → tableaux PHP → HTML
A reter :

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.

$dsn = "mysql:host=127.0.0.1;port=3306;dbname=blog_recettes;charset=utf8mb4";
A reter :

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.

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

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

$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");
$requete->execute(["id" => 1]);
A reter :

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.

// La valeur arrive séparément du SQL.
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE titre = :titre");
$requete->execute(["titre" => $titre]);
A reter :

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.

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.

session_start();
$_SESSION['csrf'] = bin2hex(random_bytes(32));
A reter :

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.

header('Location: recette.php?id=' . $nouvelId, true, 303);
exit;
A reter :

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.

$nouvelId = (int) $pdo->lastInsertId();
A reter :

Não presumir que a nova receita terá o id 4: AUTO_INCREMENT pode ter lacunas.