Jak prawidłowo obsługiwać wyjątki?

Question

Accepted Answer

PHP obsługuje błędy za pomocą **wyjątków** przechwytywanych przez `try/catch/finally`. Prawidłowa obsługa wyjątków oznacza przechwytywanie określonych typów, tworzenie sensownych wyjątków niestandardowych, czyszczenie zasobów i nigdy nie ujawnianie użytkownikom wewnętrznych szczegółów. ## Struktura podstawowa ```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) } ``` Przechwytuj **konkretne** typy wyjątków (najpierw najbardziej konkretne), używaj `Throwable` jako ostatniego łapacza dla wszystko (obejmuje zarówno `Error` jak i `Exception`), i używaj `finally` do czyszczenia, które musi zawsze się wykonać. ## Rzucanie i wyjątki niestandardowe ```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); ``` Niestandardowe klasy wyjątków sprawiają, że obsługa błędów jest wyrazista i pozwalają wywołującym przechwytywać konkretne błędy domenowe. ## Łańcuchowanie wyjątków (zachowanie przyczyny) ```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); } ``` Trzeci argument konstruktora łańcuchuje oryginalny wyjątek (`$e->getPrevious()`), zachowując pełną przyczynę do debugowania. ## Najlepsze praktyki ```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) ``` ## Dlaczego to ważne Prawidłowa obsługa wyjątków jest niezbędna do budowania solidnych, niezawodnych i bezpiecznych aplikacji PHP. Zrozumienie struktury `try/catch/finally`, przechwytywania **konkretnych** typów wyjątków (do obsługi ukierunkowanej) z `Throwable` jako ostatniego łapacza (obejmującego zarówno `Error` i `Exception` w nowoczesnym PHP) oraz używania `finally` do gwarantowanego czyszczenia jest fundamentalną wiedzą codzienną. Poza mechaniką, ważne są najlepsze praktyki: tworzenie **sensownych wyjątków niestandardowych** dla błędów domenowych sprawia, że kod jest wyrazisty i pozwala wywołującym obsługiwać konkretne niepowodzenia; **łańcuchowanie wyjątków** zachowuje pierwotną przyczynę do debugowania; i krytycznie ważne, **nie wyciszanie wyjątków po cichu** (zamiast tego logowanie lub ponowne rzucanie) zapobiega ukrytym niepowodzeniom. Osobliwie ważny punkt to **bezpieczeństwo**: wyjątki i błędy powinny być **logowane wewnętrznie, ale nigdy nie ujawniane użytkownikom** (ślady stosu i wewnętrzne szczegóły ujawniają wrażliwe informacje i pomagają atakującym — stąd `display_errors` off w produkcji). Wiedza o prawidłowej obsłudze wyjątków — konkretne łapacze, wyjątki niestandardowe, czyszczenie, łańcuchowanie i bezpieczne logowanie zamiast ujawniania — odróżnia solidny, profesjonalny PHP od kruchego kodu, który pada niepomyślnie lub ujawnia informacje, czyniąc to ważną wiedzą do budowania niezawodnych, bezpiecznych aplikacji.