3.5 mysqli e PDO no PHP
Conectar o PHP ao MySQL com PDO e mysqli: DSN com utf8mb4, exceções, prepared statements contra SQL Injection, fetch e fetchAll, lastInsertId e erros sem vazar dados.
Duas extensões para falar com o MySQL
| mysqli | PDO | |
|---|---|---|
| Bancos | MySQL / MariaDB | vários (troca o DSN; o SQL específico pode mudar) |
| Placeholders | ? | ? ou :nome |
| Erros no PHP 8 | exceção desde o 8.1 | exceção desde o 8.0 |
| Consulta com parâmetros | execute_query($sql, [...]) (8.2+) | prepare() + execute([...]) |
⚠ A página original diz que a API mysql_ foi "descontinuada desde o PHP 7.0". Ela foi descontinuada no PHP 5.5 e removida no PHP 7.0.
Conectando com PDO
<?php
// config/database.php (NÃO versionar; no Git fica database.example.php)
return [
'dsn' => 'mysql:host=127.0.0.1;port=3306;dbname=escola;charset=utf8mb4',
'user' => 'app_escola',
'pass' => 'troque-esta-senha',
];<?php
declare(strict_types=1);
$cfg = require __DIR__ . '/config/database.php';
try {
$pdo = new PDO($cfg['dsn'], $cfg['user'], $cfg['pass'], [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
]);
} catch (PDOException $e) {
error_log($e->getMessage()); // detalhe só no log do servidor
http_response_code(500);
exit('Serviço indisponível. Tente mais tarde.');
}No PHP 8.2+ a senha aparece como Object(SensitiveParameterValue) no stack trace, mas a mensagem da exceção ainda mostra usuário e host. Por isso ela não vai para a tela.
⚠ A página original afirma que o catch captura o erro "sem expor detalhes técnicos ao usuário final", mas todos os exemplos fazem echo … $e->getMessage(). Com senha errada, a tela mostra Access denied for user 'usuario'@'localhost' (using password: YES).
Prepared statements
Errado
$nome = $_GET['nome'];
$sql = "SELECT COUNT(*) FROM alunos
WHERE nome = '$nome'";
$total = $pdo->query($sql)->fetchColumn();
// com nome = x' OR '1'='1
// Saída: conta TODOS os alunosCerto
$stmt = $pdo->prepare(
'SELECT COUNT(*) FROM alunos
WHERE nome = :nome'
);
$stmt->execute(['nome' => $_GET['nome'] ?? '']);
$total = $stmt->fetchColumn();
// Saída: 0 para o mesmo ataque// INSERT, UPDATE e DELETE seguem o mesmo molde
$stmt = $pdo->prepare('UPDATE alunos SET curso = :curso WHERE id = :id');
$stmt->execute(['curso' => 'Física', 'id' => 7]);
echo $stmt->rowCount(); // linhas realmente alteradasLendo resultados com PDO
$stmt = $pdo->prepare('SELECT id, nome, idade FROM alunos WHERE id = :id');
$stmt->execute(['id' => 1]);
$aluno = $stmt->fetch(); // ['id' => 1, 'nome' => 'Maria', 'idade' => 20]
if ($aluno === false) {
// não encontrado
}
$todos = $pdo->query('SELECT id, nome FROM alunos ORDER BY nome')->fetchAll();
$qtd = $pdo->query('SELECT COUNT(*) FROM alunos')->fetchColumn();
$pdo->prepare('INSERT INTO alunos (nome, idade) VALUES (?, ?)')
->execute(['Maria Oliveira', 19]);
$id = (int) $pdo->lastInsertId(); // converta: vem como "4"Com o driver mysqlnd (padrão), colunas INT já chegam como int no PHP 8.1+. O lastInsertId() continua devolvendo string.
mysqli no PHP 8
<?php
declare(strict_types=1);
$cfg = require __DIR__ . '/config/mysqli.php'; // host, user, pass, db
$con = new mysqli($cfg['host'], $cfg['user'], $cfg['pass'], $cfg['db']);
$con->set_charset('utf8mb4');
$res = $con->execute_query(
'SELECT id, nome FROM alunos WHERE curso = ?',
[$_GET['curso'] ?? '']
);
foreach ($res->fetch_all(MYSQLI_ASSOC) as $a) {
echo htmlspecialchars($a['nome']), '<br>';
}
$st = $con->prepare('INSERT INTO alunos (nome, idade, curso) VALUES (?, ?, ?)');
$st->bind_param('sis', $nome, $idade, $curso); // variáveis por referência
$nome = 'Carlos Pereira'; $idade = 17; $curso = 'Matemática';
$st->execute();
echo $con->insert_id; // Saída: id gerado (int)⚠ Os exemplos de conexão da página original testam if ($mysqli->connect_error) / if (!$conn). Desde o PHP 8.1 o mysqli lança exceção por padrão: com senha errada o script termina em Fatal error: Uncaught mysqli_sql_exception e o if nunca é avaliado.
⚠ A página original apresenta o mysqli como protegido contra SQL Injection por ter consultas preparadas, mas todos os seus exemplos de mysqli usam query() com os valores escritos dentro da SQL; nenhum usa prepare() ou execute_query().
⚠ Nos exemplos de CRUD com mysqli da página original, o bloco finally { $con->close(); } quebra se a conexão falhar: $con nunca foi criada e o PHP emite Warning: Undefined variable $con seguido de Fatal error: Call to a member function close() on null.
Revisão rápida
No PHP 8, preciso configurar ERRMODE_EXCEPTION no PDO?
Não é obrigatório: é o padrão desde o PHP 8.0. Deixar explícito nas opções não faz mal e documenta a intenção.
Qual a diferença entre charset=utf8 e charset=utf8mb4?
No MySQL, utf8 é o utf8mb3, que só guarda até 3 bytes por caractere: emojis falham (erro 1366). utf8mb4 é o UTF-8 completo.
O que $stmt->fetch() devolve quando o SELECT não encontra nada?
false. Compare com === false antes de usar a linha.
Por que $pdo->query("… WHERE id = $id") é perigoso se $id veio da URL?
O conteúdo da URL entra como parte da SQL e pode alterá-la (SQL Injection). Use prepare com :id e passe o valor no execute.
Onde guardar a senha do banco?
Num arquivo de configuração fora da pasta pública e fora do Git (no .gitignore), ou em variável de ambiente. No repositório fica só um modelo sem senha.