Como você lida com exceções corretamente?

Question

Accepted Answer

PHP lida com erros com **exceções** capturadas via `try/catch/finally`. O tratamento adequado de exceções significa capturar tipos específicos, criar exceções customizadas significativas, limpar recursos e nunca expor detalhes internos aos usuários. ## A estrutura básica ```php getMessage()); } catch (DatabaseException $e) { handleDbError($e); } catch (Throwable $e) { // catch-all (Error OR Exception) — last logError($e); throw $e; // re-throw what you can't handle } finally { cleanup(); // ALWAYS runs (success or failure) } ``` Capture tipos de exceção **específicos** (mais específico primeiro), use `Throwable` como um catch-all final (cobre tanto `Error` quanto `Exception`), e use `finally` para limpeza que deve sempre executar. ## Lançando e exceções customizadas ```php // throwing if ($amount < 0) { throw new InvalidArgumentException("Amount must be positive, got $amount"); } // a custom exception for your domain class InsufficientFundsException extends Exception { public function __construct(private float $shortfall) { parent::__construct("Short by $shortfall"); } public function getShortfall(): float { return $this->shortfall; } } throw new InsufficientFundsException(50.0); ``` Classes de exceção customizadas tornam o tratamento de erros expressivo e permitem que chamadores capturem erros específicos do domínio. ## Encadeamento de exceções (preserve a causa) ```php try { $db->query(...); } catch (PDOException $e) { // wrap with context, preserving the original as the "previous" exception throw new RepositoryException("Failed to load user", 0, $e); } ``` O terceiro argumento do construtor encadeia a exceção original (`$e->getPrevious()`), preservando a causa completa para depuração. ## Boas práticas ```text ✓ Catch SPECIFIC exceptions, not a blanket Throwable (unless intentionally last) ✓ Don't swallow exceptions silently (empty catch) — log or re-throw ✓ Use finally / proper cleanup for resources (files, connections) ✓ Create meaningful custom exceptions for domain errors ✓ SECURITY: log details internally; show users a generic message (don't leak stack traces / internal info — display_errors off in production) ``` ## Por que isso importa O tratamento adequado de exceções é essencial para construir aplicações PHP robustas, confiáveis e seguras. Compreender a estrutura `try/catch/finally`, capturar tipos de exceção **específicos** (para manipulação direcionada) com `Throwable` como um catch-all final (cobrindo tanto `Error` quanto `Exception` no PHP moderno), e usar `finally` para limpeza garantida é conhecimento fundamental do dia a dia. Além da mecânica, as boas práticas importam: criar **exceções customizadas significativas** para erros do domínio torna o código expressivo e permite que chamadores lidem com falhas específicas; **encadeamento de exceções** preserva a causa raiz para depuração; e crucialmente, **não engolir exceções silenciosamente** (registrando ou relançando em vez disso) previne falhas ocultas. Um ponto particularmente importante é **segurança**: exceções e erros devem ser **registrados internamente mas nunca expostos aos usuários** (stack traces e detalhes internos vazam informações sensíveis e auxiliam atacantes — daí `display_errors` desativado em produção). Saber como lidar com exceções corretamente — capturas específicas, exceções customizadas, limpeza, encadeamento, e registro seguro em vez de exposição — distingue PHP robusto e profissional de código frágil que quebra sem elegância ou vaza informações, tornando conhecimento importante para construir aplicações confiáveis e seguras.