Wyjątki a dokumentacja kodu

Założenie: Pokażemy, jak poprawnie obsługiwać wyjątki w PHP i dokumentować ten proces, tworząc czytelne komunikaty o błędach.

Krok po kroku:

1. Tworzenie prostego wyjątku: Wyjątki w PHP są tworzone za pomocą klasy `Exception` lub jej pochodnych. Poniższy kod tworzy prosty wyjątek, jeśli podana wartość jest mniejsza od zera:

getMessage();
}
?>
				

Ten kod definiuje funkcję sprawdzWiek, która rzuca wyjątek, jeśli wiek jest ujemny. Blok try...catch łapie wyjątek i wyświetla komunikat o błędzie.

2. Obsługa różnych typów wyjątków: Możemy tworzyć własne klasy wyjątków, aby lepiej zarządzać różnymi typami błędów:

getMessage();
} catch (Exception $e) {
  echo "Wystąpił inny błąd: " . $e->getMessage();
}
?>
				

Tutaj definiujemy klasę WiekUjemnyException, która dziedziczy po klasie `Exception`. Dzięki temu możemy obsługiwać ten konkretny typ wyjątku osobno.

3. Dokumentowanie obsługi wyjątków: Ważne jest, aby dokumentować, jak kod obsługuje wyjątki. Można to zrobić za pomocą komentarzy w kodzie:

Dodanie komentarzy typu docblock ułatwia zrozumienie, jakie wyjątki mogą być rzucone przez funkcję.

Ten przykład pokazuje podstawy obsługi wyjątków w PHP i ich dokumentowania. Zachęcamy do dalszego zgłębiania tematu, aby pisać bardziej solidny i łatwy w utrzymaniu kod.