Wyjątki
*******
Nette Database używa hierarchii wyjątków. Klasą bazową jest `Nette\Database\DriverException`, która rozszerza `PDOException` i udostępnia rozszerzoną funkcjonalność pracy z błędami bazy danych:
- Metoda `getDriverCode()` zwraca kod błędu ze sterownika bazy danych.
- Metoda `getSqlState()` zwraca kod SQLSTATE.
- Metody `getQueryString()` i `getParameters()` pozwalają pobrać oryginalne zapytanie i jego parametry.
Klasę `DriverException` rozszerzają następujące wyspecjalizowane wyjątki:
- `ConnectionException` - sygnalizuje niepowodzenie połączenia z serwerem bazy danych.
- `ConnectionLostException` .{data-version:3.2.9} - połączenie zostało przerwane w trakcie operacji (restart serwera, awaria sieci, idle timeout); przed dalszym użyciem konieczne jest ponowne połączenie.
- `ConstraintViolationException` - klasa bazowa dla naruszeń ograniczeń bazy danych, po której dziedziczą poniższe wyjątki:
- `ForeignKeyConstraintViolationException` - naruszenie ograniczenia klucza obcego.
- `NotNullConstraintViolationException` - naruszenie ograniczenia NOT NULL.
- `UniqueConstraintViolationException` - naruszenie ograniczenia unikalności.
- `CheckConstraintViolationException` .{data-version:3.2.9} - naruszenie ograniczenia CHECK.
- `DeadlockException` .{data-version:3.2.9} - deadlock albo konflikt serializacji wykryty przez serwer; transakcja została wycofana i można ją powtórzyć.
- `LockTimeoutException` .{data-version:3.2.9} - przekroczono czas oczekiwania na blokadę; polecenie zostało przerwane, ale otaczająca transakcja zwykle pozostaje otwarta.
Poniższy przykład pokazuje, jak przechwycić `UniqueConstraintViolationException`, który powstaje przy próbie wstawienia użytkownika z e-mailem już istniejącym w bazie danych (przy założeniu, że kolumna `email` ma indeks unikalny):
```php
try {
$database->query('INSERT INTO users', [
'email' => 'john@example.com',
'name' => 'John Doe',
'password' => $hashedPassword,
]);
} catch (Nette\Database\UniqueConstraintViolationException $e) {
echo 'Użytkownik z tym e-mailem już istnieje.';
} catch (Nette\Database\DriverException $e) {
echo 'Podczas rejestracji wystąpił błąd: ' . $e->getMessage();
}
```
Wyjątki
Nette Database używa hierarchii wyjątków. Klasą bazową jest Nette\Database\DriverException, która rozszerza
PDOException i udostępnia rozszerzoną funkcjonalność pracy z błędami bazy danych:
- Metoda
getDriverCode() zwraca kod błędu ze sterownika bazy danych.
- Metoda
getSqlState() zwraca kod SQLSTATE.
- Metody
getQueryString() i getParameters() pozwalają pobrać oryginalne zapytanie i jego
parametry.
Klasę DriverException rozszerzają następujące wyspecjalizowane wyjątki:
ConnectionException – sygnalizuje niepowodzenie połączenia z serwerem bazy danych.
ConnectionLostException .{data-version:3.2.9} – połączenie zostało przerwane w trakcie operacji (restart
serwera, awaria sieci, idle timeout); przed dalszym użyciem konieczne jest ponowne połączenie.
ConstraintViolationException – klasa bazowa dla naruszeń ograniczeń bazy danych, po której dziedziczą
poniższe wyjątki:
ForeignKeyConstraintViolationException – naruszenie ograniczenia klucza obcego.
NotNullConstraintViolationException – naruszenie ograniczenia NOT NULL.
UniqueConstraintViolationException – naruszenie ograniczenia unikalności.
CheckConstraintViolationException .{data-version:3.2.9} – naruszenie ograniczenia CHECK.
DeadlockException .{data-version:3.2.9} – deadlock albo konflikt serializacji wykryty przez serwer; transakcja
została wycofana i można ją powtórzyć.
LockTimeoutException .{data-version:3.2.9} – przekroczono czas oczekiwania na blokadę; polecenie zostało
przerwane, ale otaczająca transakcja zwykle pozostaje otwarta.
Poniższy przykład pokazuje, jak przechwycić UniqueConstraintViolationException, który powstaje przy próbie
wstawienia użytkownika z e-mailem już istniejącym w bazie danych (przy założeniu, że kolumna email ma indeks
unikalny):
try {
$database->query('INSERT INTO users', [
'email' => 'john@example.com',
'name' => 'John Doe',
'password' => $hashedPassword,
]);
} catch (Nette\Database\UniqueConstraintViolationException $e) {
echo 'Użytkownik z tym e-mailem już istnieje.';
} catch (Nette\Database\DriverException $e) {
echo 'Podczas rejestracji wystąpił błąd: ' . $e->getMessage();
}