A Bíblia PHP

Consultai e programareis.

BÍBLIA DE CONSULTA

Segurança

Valide entradas, escape saídas e proteja dados.

Escapar HTML com htmlspecialchars

Escape texto dinâmico ao inseri-lo em HTML. Use ENT_QUOTES, ENT_SUBSTITUTE e UTF-8 para cobrir aspas e texto inválido.

SINTAXE

htmlspecialchars($texto, ENT_QUOTES | ENT_SUBSTITUTE, "UTF-8")

Exemplo

Navegador
<?php
$entrada = "<script>alert(1)</script>";
echo htmlspecialchars($entrada, ENT_QUOTES | ENT_SUBSTITUTE, "UTF-8");

Como usar: Coloque a saída dentro de um documento HTML e abra no navegador; o texto será exibido, não executado.

Escape texto dinâmico ao inseri-lo em HTML. Use ENT_QUOTES, ENT_SUBSTITUTE e UTF-8 para cobrir aspas e texto inválido. Erro comum: Imprimir entrada diretamente em HTML e permitir XSS.

Resultado esperado: As tags aparecem como texto inofensivo.

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Imprimir entrada diretamente em HTML e permitir XSS.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar em servidor PHP local.

Validar entradas

Valide tipo, formato, tamanho e faixa conforme a regra do negócio. Sanitização não substitui validação nem escape de saída.

SINTAXE

filter_var($valor, FILTER_VALIDATE_EMAIL)

Exemplo

Terminal
<?php
$email = "leitor@example.com";
if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
    echo "Formato válido" . PHP_EOL;
}

Como usar: Salve como validar.php e execute php validar.php.

Valide tipo, formato, tamanho e faixa conforme a regra do negócio. Sanitização não substitui validação nem escape de saída. Erro comum: Aceitar qualquer conteúdo só porque foi filtrado por uma função.

Resultado esperado: Formato válido

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Aceitar qualquer conteúdo só porque foi filtrado por uma função.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar no terminal.

SQL injection e parâmetros

Não concatene entrada em SQL. Prepared statements separam consulta e valores, reduzindo risco de injeção SQL.

SINTAXE

$pdo->prepare("... WHERE campo = :valor")

Exemplo

Terminal
<?php
$sql = "SELECT id FROM usuarios WHERE email = :email";
$stmt = $pdo->prepare($sql);
$stmt->execute(["email" => $email]);

Como usar: Trecho ilustrativo: requer PDO e tabela de teste. Nunca concatene $email na string SQL.

Não concatene entrada em SQL. Prepared statements separam consulta e valores, reduzindo risco de injeção SQL. Erro comum: Montar SQL usando concatenação de strings recebidas do usuário.

Resultado esperado: Consulta busca apenas a linha associada ao valor.

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Montar SQL usando concatenação de strings recebidas do usuário.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar no terminal.

CSRF em formulários

Um token aleatório guardado na sessão e enviado no formulário ajuda a rejeitar requisições forjadas. Compare tokens com hash_equals().

SINTAXE

hash_equals($esperado, $recebido)

Exemplo

Navegador
<?php
session_start();
$_SESSION["csrf"] ??= bin2hex(random_bytes(32));
echo htmlspecialchars($_SESSION["csrf"], ENT_QUOTES, "UTF-8");

Como usar: Em aplicação real, inclua token em campo hidden e valide no POST com hash_equals antes da ação.

Um token aleatório guardado na sessão e enviado no formulário ajuda a rejeitar requisições forjadas. Compare tokens com hash_equals(). Erro comum: Token sem validação no servidor ou ação sensível via GET.

Resultado esperado: Token imprevisível associado à sessão.

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Token sem validação no servidor ou ação sensível via GET.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar em servidor PHP local.

password_hash e password_verify

password_hash() cria hash de senha com algoritmo apropriado; password_verify() valida a senha. Nunca armazene senha em texto puro.

SINTAXE

password_hash($senha, PASSWORD_DEFAULT)

Exemplo

Terminal
<?php
$hash = password_hash("senha-de-exemplo", PASSWORD_DEFAULT);
var_dump(password_verify("senha-de-exemplo", $hash));

Como usar: Salve como senha.php e execute php senha.php. Use a senha apenas como exemplo local.

password_hash() cria hash de senha com algoritmo apropriado; password_verify() valida a senha. Nunca armazene senha em texto puro. Erro comum: Comparar hashes diretamente: o salt muda o resultado de cada hash.

Resultado esperado: bool(true).

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Comparar hashes diretamente: o salt muda o resultado de cada hash.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar no terminal.

Segredos fora do código

Guarde credenciais em variáveis de ambiente ou arquivo protegido fora da pasta pública. Separe conta de leitura da conta de manutenção e limite privilégios.

SINTAXE

getenv("DB_PASSWORD")

Exemplo

Terminal
<?php
$senha = getenv("DB_PASSWORD");
if ($senha === false || $senha === "") {
    throw new RuntimeException("DB_PASSWORD não configurada");
}
echo "Configuração presente." . PHP_EOL;

Como usar: Defina DB_PASSWORD no ambiente do processo; nunca imprima seu valor nem o registre em logs.

Guarde credenciais em variáveis de ambiente ou arquivo protegido fora da pasta pública. Separe conta de leitura da conta de manutenção e limite privilégios. Erro comum: Comitar .env, deixar arquivo legível publicamente ou compartilhar senha em comandos.

Resultado esperado: Apenas uma confirmação sem revelar o segredo.

Atenção: Este código é texto para estudo e não é executado pela Bíblia PHP.

Erro comum: Comitar .env, deixar arquivo legível publicamente ou compartilhar senha em comandos.

Desafio opcional

Adapte o exemplo para um valor diferente, preveja a saída e só então execute o código.

Ver uma dica

Dica: identifique a variável ou condição que controla o resultado.

Ambiente: PHP 8.4 como referência; executar no terminal.