Исключения
**********
Nette Database использует иерархию исключений. Базовый класс - `Nette\Database\DriverException`, который расширяет `PDOException` и даёт дополнительные возможности для работы с ошибками базы данных:
- Метод `getDriverCode()` возвращает код ошибки от драйвера базы данных.
- Метод `getSqlState()` возвращает код SQLSTATE.
- Методы `getQueryString()` и `getParameters()` позволяют получить исходный запрос и его параметры.
Класс `DriverException` расширяют следующие специализированные исключения:
- `ConnectionException` - обозначает неудачу при подключении к серверу базы данных.
- `ConnectionLostException` - соединение было разорвано во время операции (перезапуск сервера, сбой сети, idle timeout); перед дальнейшим использованием нужно переподключиться. .{data-version:3.2.9}
- `ConstraintViolationException` - базовый класс для нарушений ограничений базы данных, от которого наследуются следующие исключения:
- `ForeignKeyConstraintViolationException` - нарушение ограничения внешнего ключа.
- `NotNullConstraintViolationException` - нарушение ограничения NOT NULL.
- `UniqueConstraintViolationException` - нарушение ограничения уникальности.
- `CheckConstraintViolationException` - нарушение ограничения CHECK. .{data-version:3.2.9}
- `DeadlockException` - deadlock или сериализационный конфликт, обнаруженный сервером; транзакция была откачена и может быть повторена. .{data-version:3.2.9}
- `LockTimeoutException` - превышено время ожидания блокировки; инструкция была прервана, но окружающая транзакция обычно остаётся открытой. .{data-version:3.2.9}
Следующий пример показывает, как перехватить `UniqueConstraintViolationException`, которое возникает при попытке вставить пользователя с адресом электронной почты, уже существующим в базе данных (при условии, что у столбца `email` есть уникальный индекс):
```php
try {
$database->query('INSERT INTO users', [
'email' => 'john@example.com',
'name' => 'John Doe',
'password' => $hashedPassword,
]);
} catch (Nette\Database\UniqueConstraintViolationException $e) {
echo 'A user with this email already exists.';
} catch (Nette\Database\DriverException $e) {
echo 'An error occurred during registration: ' . $e->getMessage();
}
```
Исключения
Nette Database использует иерархию исключений. Базовый класс –
Nette\Database\DriverException, который расширяет PDOException и даёт
дополнительные возможности для работы с ошибками базы данных:
- Метод
getDriverCode() возвращает код ошибки от драйвера базы
данных.
- Метод
getSqlState() возвращает код SQLSTATE.
- Методы
getQueryString() и getParameters() позволяют получить
исходный запрос и его параметры.
Класс DriverException расширяют следующие специализированные
исключения:
ConnectionException – обозначает неудачу при подключении к серверу
базы данных.
ConnectionLostException – соединение было разорвано во
время операции (перезапуск сервера, сбой сети, idle timeout); перед
дальнейшим использованием нужно переподключиться.
ConstraintViolationException – базовый класс для нарушений ограничений
базы данных, от которого наследуются следующие исключения:
ForeignKeyConstraintViolationException – нарушение ограничения внешнего
ключа.
NotNullConstraintViolationException – нарушение ограничения NOT NULL.
UniqueConstraintViolationException – нарушение ограничения уникальности.
CheckConstraintViolationException – нарушение ограничения CHECK.
DeadlockException – deadlock или сериализационный конфликт,
обнаруженный сервером; транзакция была откачена и может быть
повторена.
LockTimeoutException – превышено время ожидания
блокировки; инструкция была прервана, но окружающая транзакция обычно
остаётся открытой.
Следующий пример показывает, как перехватить
UniqueConstraintViolationException, которое возникает при попытке вставить
пользователя с адресом электронной почты, уже существующим в базе
данных (при условии, что у столбца email есть уникальный индекс):
try {
$database->query('INSERT INTO users', [
'email' => 'john@example.com',
'name' => 'John Doe',
'password' => $hashedPassword,
]);
} catch (Nette\Database\UniqueConstraintViolationException $e) {
echo 'A user with this email already exists.';
} catch (Nette\Database\DriverException $e) {
echo 'An error occurred during registration: ' . $e->getMessage();
}