Acervo.estudos
Trilhas Enviar material Entrar
mapa · Intermediário

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.

por @julio · rev. 23 set · 6 telas

mysqli × PDO

Duas extensões para falar com o MySQL

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
mysqliPDO
BancosMySQL / MariaDBvários (troca o DSN; o SQL específico pode mudar)
Placeholders?? ou :nome
Erros no PHP 8exceção desde o 8.1exceção desde o 8.0
Consulta com parâmetrosexecute_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.

DSN, opções, senha fora do código e erros

Conectando com PDO

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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).

Dado do usuário nunca entra colado na SQL

Prepared statements

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom

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 alunos

Certo

$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 alteradas
fetch, fetchAll, fetchColumn, lastInsertId

Lendo resultados com PDO

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
$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.

Exceções por padrão e consultas preparadas

mysqli no PHP 8

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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.

Teste antes de seguir

Revisão rápida

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
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.

← Voltar ao curso