A Bíblia PHP

Consultai e programareis.

BÍBLIA DE CONSULTA

Erros

Encontre problemas e trate exceções com clareza.

php -l e erros de sintaxe

php -l verifica sintaxe sem executar o arquivo. Leia a linha indicada e confira parênteses, chaves, aspas e ponto e vírgula.

SINTAXE

php -l arquivo.php

Exemplo

Terminal
<?php
echo "Sintaxe válida" . PHP_EOL;

Como usar: Salve como sintaxe.php e execute php -l sintaxe.php.

php -l verifica sintaxe sem executar o arquivo. Leia a linha indicada e confira parênteses, chaves, aspas e ponto e vírgula. Erro comum: Confundir erro de sintaxe com erro de lógica ou de ambiente.

Resultado esperado: No syntax errors detected.

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

Erro comum: Confundir erro de sintaxe com erro de lógica ou de ambiente.

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.

var_dump e print_r

var_dump() mostra tipo e valor; print_r() apresenta arrays e objetos de forma legível. Use-os durante desenvolvimento, não para expor dados sensíveis.

SINTAXE

var_dump($valor); print_r($array);

Exemplo

Terminal
<?php
$dados = ["nome" => "Eva", "ativo" => true];
print_r($dados);
var_dump($dados["ativo"]);

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

var_dump() mostra tipo e valor; print_r() apresenta arrays e objetos de forma legível. Use-os durante desenvolvimento, não para expor dados sensíveis. Erro comum: Deixar informações pessoais ou credenciais em saída pública de depuração.

Resultado esperado: Estrutura do array e bool(true).

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

Erro comum: Deixar informações pessoais ou credenciais em saída pública de depuraçã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.

try e catch

Exceções podem ser tratadas com try/catch. Capture tipos específicos quando souber como reagir; não esconda falhas silenciosamente.

SINTAXE

try { ... } catch (Exception $e) { ... }

Exemplo

Terminal
<?php
try {
    throw new RuntimeException("Exemplo");
} catch (RuntimeException $erro) {
    echo "Falha tratada." . PHP_EOL;
}

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

Exceções podem ser tratadas com try/catch. Capture tipos específicos quando souber como reagir; não esconda falhas silenciosamente. Erro comum: Capturar toda exceção e continuar como se a operação tivesse dado certo.

Resultado esperado: Falha tratada.

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

Erro comum: Capturar toda exceção e continuar como se a operação tivesse dado certo.

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.

Registro de erros

error_log() envia mensagem para o log configurado pelo PHP. Registre contexto útil sem senhas, tokens ou dados pessoais desnecessários.

SINTAXE

error_log($mensagem);

Exemplo

Terminal
<?php
error_log("Falha ao processar tarefa demo; código=E100");
echo "Consulte o log do servidor." . PHP_EOL;

Como usar: Execute em ambiente local e consulte o destino configurado para error_log.

error_log() envia mensagem para o log configurado pelo PHP. Registre contexto útil sem senhas, tokens ou dados pessoais desnecessários. Erro comum: Exibir stack trace, caminho interno ou segredo ao visitante.

Resultado esperado: A mensagem é enviada ao log PHP.

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

Erro comum: Exibir stack trace, caminho interno ou segredo ao visitante.

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.