PDO — As bases

Guia 02 / 4

Os essenciais de PDO

Um memorando explicado: para que serve cada elemento, como escrevê-lo e quando utilizá-lo.

Resultado esperado :

Escolher e utilizar os elementos essenciais para realizar esta etapa do blogue.

Leitura
0%

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.

php -v
php -m
A reter :

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.

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

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.

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

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.

$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];
A reter :

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.

$categories = $pdo->query('SELECT id, nom FROM categories ORDER BY nom')->fetchAll();
A reter :

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.

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

$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->bindValue(':id', 1, PDO::PARAM_INT);
$requete->execute();
A reter :

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.

$recette = $requete->fetch();
if ($recette === false) {
    http_response_code(404);
    exit("Recette introuvable.");
}
A reter :

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.

$requete = $pdo->prepare('SELECT titre FROM recettes WHERE titre LIKE :recherche');
$requete->execute(['recherche' => '%' . $q . '%']);
A reter :

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.

$requete = $pdo->query('SELECT COUNT(*) FROM recettes');
$total = (int) $requete->fetchColumn();
A reter :

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.

$requete = $pdo->prepare(
    'INSERT INTO categories (nom) VALUES (:nom)'
);
$requete->execute(['nom' => 'Goûter']);
$id = (int) $pdo->lastInsertId();
A reter :

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.

$pdo->beginTransaction();
$requete = $pdo->prepare('UPDATE recettes SET duree_minutes = :duree WHERE id = :id');
$requete->execute(['duree' => 25, 'id' => 1]);
$pdo->rollBack();
A reter :

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.

$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;
}
A reter :

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.

Entrée → vérifier type et bornes
Écriture → lier les valeurs SQL
Affichage → échapper avec h
Formulaire POST → comparer le jeton de session
A reter :

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.