Guia 02 / 4
Os essenciais de PDO
Um memorando explicado: para que serve cada elemento, como escrevê-lo e quando utilizá-lo.
Escolher e utilizar os elementos essenciais para realizar esta etapa do blogue.
01 · Configurar uma ligação compreensível
A configuração pertence ao servidor, nunca ao código JavaScript enviado ao navegador.
Verificar as extensões
O binário PHP que lança o servidor deve conhecer pdo_mysql e mbstring. php -m apresenta as extensões disponíveis.
Exemplo
php -v
php -m
could not find driver indica geralmente que o controlador PDO correspondente não está ativado.
Conta MySQL da aplicação
Com uma conta de administrador local, criar uma conta limitada à base de dados do blogue. Substituir a palavra-passe de exemplo e reter a mesma conta para as variáveis de ambiente.
Exemplo
CREATE USER 'blog_app'@'127.0.0.1' IDENTIFIED BY 'REMPLACER_PAR_UN_MOT_DE_PASSE_LOCAL';
GRANT SELECT, INSERT, UPDATE, DELETE ON blog_recettes.* TO 'blog_app'@'127.0.0.1';
Executar uma única vez no MySQL, e não no PHP. A conta não precisa de criar nem eliminar tabelas; adaptar o anfitrião à instalação local, se necessário.
Variáveis de ambiente e servidor local
No terminal Bash que lançará o PHP, definir a conta e digitar a palavra-passe sem a colocar num comando guardado. Os outros sistemas utilizam o seu mecanismo equivalente para fornecer as mesmas variáveis.
Exemplo
export DB_HOST=127.0.0.1
export DB_PORT=3306
export DB_NAME=blog_recettes
export DB_USER=blog_app
read -r -s -p 'Mot de passe MySQL : ' DB_PASSWORD
export DB_PASSWORD
php -S 127.0.0.1:8000 -t public
Estas linhas digitam-se a partir de mini-blog/. Não acrescentar aspas SQL à palavra-passe digitada. Nenhum ficheiro .env é carregado automaticamente por estes exemplos.
Opções do construtor PDO
O modo de exceção facilita o tratamento dos erros. FETCH_ASSOC fornece tabelas com nome. Desativar a emulação pede ao controlador MySQL preparações nativas.
Exemplo
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
O ficheiro completo includes/db.php devolve a ligação configurada; as páginas carregam-no com require.
02 · Preparar, executar e ler
Escrever primeiro o SQL esperado e acrescentar depois os valores externos como parâmetros.
query para uma consulta fixa
query executa diretamente uma consulta cujo texto é inteiramente fixo. As categorias não dependem de nenhuma introdução do utilizador.
Exemplo
$categories = $pdo->query('SELECT id, nom FROM categories ORDER BY nom')->fetchAll();
Logo que um valor externo intervenha, utilizar prepare e os parâmetros.
prepare e execute
prepare descreve a estrutura da consulta; execute fornece os seus valores e executa-a. As chaves da tabela correspondem aos nomes dos parâmetros.
Exemplo
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->execute(['id' => 1]);
$recette = $requete->fetch();
bindValue com tipo explícito
bindValue fixa um valor antes de execute. PARAM_INT especifica que se trata de um inteiro, útil para os identificadores e os limites.
Exemplo
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->bindValue(':id', 1, PDO::PARAM_INT);
$requete->execute();
Para uma dada consulta, escolher ou execute com tabela, ou bindValue e depois execute sem tabela.
fetch, fetchAll e ausência de resultado
fetch devolve uma linha ou false. fetchAll devolve uma tabela de linhas, vazia se não houver nenhuma. Uma ausência não é necessariamente um erro SQL.
Exemplo
$recette = $requete->fetch();
if ($recette === false) {
http_response_code(404);
exit("Recette introuvable.");
}
Para o pequeno blogue, fetchAll é legível. Uma grande coleção exigiria paginação em vez de carregar tudo.
LIKE e padrão ligado
O parâmetro contém o padrão completo. Acrescenta-se % ao valor transmitido, sem o colocar à volta do nome do parâmetro no SQL.
Exemplo
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE titre LIKE :recherche');
$requete->execute(['recherche' => '%' . $q . '%']);
Nesta oficina, % e _ digitados mantêm o seu sentido de carateres universais SQL. É uma pesquisa por padrão, nem sempre uma pesquisa literal.
Contar os resultados de leitura
Para o pequeno resultado já carregado, utilizar count. Para contar na base de dados, pedir SELECT COUNT(*) e depois fetchColumn.
Exemplo
$requete = $pdo->query('SELECT COUNT(*) FROM recettes');
$total = (int) $requete->fetchColumn();
Não utilizar rowCount para contar as linhas de um SELECT: este comportamento não é portável.
03 · Escrever e proteger as fronteiras
A base de dados armazena texto bruto; o HTML é escapado no momento da apresentação.
INSERT e lastInsertId
Enumerar as colunas e ligar cada valor. O ficheiro completo de adição verifica primeiro todos os campos e a categoria.
Exemplo
$requete = $pdo->prepare(
'INSERT INTO categories (nom) VALUES (:nom)'
);
$requete->execute(['nom' => 'Goûter']);
$id = (int) $pdo->lastInsertId();
Excerto isolado a experimentar uma única vez: nom é UNIQUE. A oficina completa acrescenta uma receita, e não uma categoria.
UPDATE e DELETE por identificador
Para uma modificação ou eliminação, o identificador verificado limita a linha em causa. O excerto abaixo é um ensaio no lado do servidor, e não uma ação desencadeada por uma ligação.
Exemplo
$pdo->beginTransaction();
$requete = $pdo->prepare('UPDATE recettes SET duree_minutes = :duree WHERE id = :id');
$requete->execute(['duree' => 25, 'id' => 1]);
$pdo->rollBack();
Para uma eliminação: DELETE FROM recettes WHERE id = :id, com parâmetro. Uma interface de edição exigiria POST, token CSRF e controlo dos direitos.
Transação sobre várias escritas
Quando várias escritas têm de ter êxito em conjunto, iniciar uma transação, validar depois da última e anular em caso de exceção. Um INSERT único já é atómico na oficina.
Exemplo
$pdo->beginTransaction();
try {
// Exécuter ici les écritures préparées liées entre elles.
$pdo->commit();
} catch (PDOException $erreur) {
if ($pdo->inTransaction()) { $pdo->rollBack(); }
throw $erreur;
}
Este modelo explica a sequência; não substitui as consultas do projeto.
Os quatro controlos do formulário
A validação protege as regras de negócio; os parâmetros protegem os espaços reservados SQL; h protege a apresentação HTML; o token verifica a origem esperada do formulário. Cada um atua num local diferente.
Exemplo
Entrée → vérifier type et bornes
Écriture → lier les valeurs SQL
Affichage → échapper avec h
Formulaire POST → comparer le jeton de session
Os exemplos servem uma oficina local. Uma colocação em linha com escrita partilhada deve também definir quem pode acrescentar, modificar ou eliminar uma receita.