# Błędy i wyjątki w PHP > Błędy i wyjątki w PHP: Throwable, Error i Exception, try/catch/finally, globalne handlery oraz bezpieczne ustawienia wyświetlania błędów i logów. Źródło: https://phpsos.de/pl/php/fehler-und-exceptions/ Stan: 25.10.2026 Dostawca: PHP SOS, Pomoc awaryjna PHP i bezpieczeństwo serwerów. Natychmiastowa pomoc przez WhatsApp: https://wa.me/491736494914?text=Dzie%C5%84%20dobry%2C%20PHP%20SOS%2C%20potrzebujemy%20pomocy%20z%20naszym%20serwerem%20PHP.%20Firma%3A%20%E2%80%A6%20Strona%20internetowa%3A%20%E2%80%A6 **Krótko:** PHP zgłasza problemy na dwa sposoby: jako klasyczne błędy, takie jak ostrzeżenia i uwagi, sterowane przez `error_reporting`, oraz jako wyjątki, które można przechwycić za pomocą `try` i `catch`. Od PHP 7 wiele błędów wewnętrznych zgłasza też obiekt klasy `Error`; razem z `Exception` implementuje on interfejs `Throwable`. W produkcji obowiązuje zasada: błędy zapisywać w logu, nigdy nie wyświetlać w przeglądarce. W PHP 8.5 do środków przejściowych z powodu PHP2Shell należy ponadto `fatal_error_backtraces=0`. ## Dwa światy: klasyczne błędy i wyjątki PHP pochodzi z czasów, gdy błędy były wyświetlane przede wszystkim jako komunikaty: uwagi (`E_NOTICE`), ostrzeżenia (`E_WARNING`), przestarzałe funkcje (`E_DEPRECATED`) i błędy krytyczne (`E_ERROR`). Wiele z tych komunikatów pozwala skryptowi działać dalej, często z błędnymi lub pustymi danymi. Wyjątki działają inaczej. Przerywają normalny przebieg i przeskakują do najbliższego pasującego bloku `catch`. Jeśli żadnego nie znajdą, skrypt się kończy. Dla osób podejmujących decyzje różnica jest ważna: ciche ostrzeżenie może sprawić, że zamówienie zostanie zapisane niekompletnie, a nikt tego nie zauważy. Wyjątek czyni problem widocznym i możliwym do obsłużenia. Niedocenianą zaletą klasycznych komunikatów są uwagi typu `E_DEPRECATED`. Zapowiadają one, że jakiś środek językowy zniknie w przyszłej wersji PHP. Kto zbiera je w logu i regularnie analizuje, wie przed aktualizacją, które miejsca trzeba poprawić, i nie musi długo testować w razie pilnej luki bezpieczeństwa. ## Hierarchia Throwable Wszystko, co można rzucić za pomocą `throw` i złapać za pomocą `catch`, implementuje `Throwable`. Poniżej są dwie gałęzie: | Klasa | Przeznaczenie | Przykłady podklas | |---|---|---| | `Exception` | przewidywalne błędy aplikacji i rozszerzeń | `ErrorException`, `PDOException`, własne klasy | | `Error` | wewnętrzne błędy PHP | `TypeError`, `ValueError`, `ArgumentCountError`, `ArithmeticError`, `DivisionByZeroError`, `UnhandledMatchError` | Własne klasy błędów dziedziczą po `Exception`, a nie po `Error`. Od PHP 8.0 większość funkcji wewnętrznych zgłasza przy nieprawidłowych parametrach `TypeError` lub `ValueError`, zamiast tylko wyświetlać ostrzeżenie. Przykładem jest `strlen([])`. ## try, catch i finally w praktyce ```php belasten($b->betrag(), $b->referenz()); return true; } catch (ZahlungFehlgeschlagen $e) { $log->warning('Zahlung abgelehnt', ['bestellung' => $b->id(), 'exception' => $e]); return false; } catch (TimeoutException | VerbindungsFehler) { // od PHP 8.0 zmienna w catch jest opcjonalna $log->error('Zahlungsdienst nicht erreichbar', ['bestellung' => $b->id()]); return false; } finally { $dienst->verbindungSchliessen(); } } ``` Kilka klas można połączyć w jednym `catch` za pomocą `|`. Blok `finally` wykonuje się zawsze, niezależnie od tego, czy wystąpił błąd. Od PHP 8.0 `throw` jest ponadto wyrażeniem i może stać na przykład za `??`: `$id = $_GET['id'] ?? throw new InvalidArgumentException('id fehlt');`. ## Globalne handlery: set_error_handler i set_exception_handler Dwie funkcje przechwytują to, co inaczej by się prześliznęło. `set_exception_handler()` rejestruje funkcję dla nieprzechwyconych obiektów Throwable. Według podręcznika skrypt kończy się po jej wywołaniu; nadaje się więc do zapisu w logu i neutralnej strony błędu, a nie do dalszej pracy. Sprawdził się handler, który zapisuje do logu pełny błąd z czasem i losowym identyfikatorem, a odwiedzającemu pokazuje tylko neutralną stronę z tym identyfikatorem. Wsparcie techniczne może wtedy odnaleźć przypadek w logu, a wewnętrzne szczegóły nie wydostają się na zewnątrz. `set_error_handler()` przechwytuje klasyczne błędy. Podręcznik pokazuje, jak zamienić je w `ErrorException`, aby ostrzeżenia były traktowane jak wyjątki: ```php