SQLite3::enableExceptions

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

SQLite3::enableExceptions — Включить выброс исключений

Описание

public SQLite3::enableExceptions(bool $enable = false): bool

Определяет, будет ли экземпляр SQLite3 выбрасывать исключения или предупреждения об ошибке.

Список параметров

enable

Когда передано значение true, экземпляр SQLite3 и экземпляры SQLite3Stmt и SQLite3Result, производные от него, будут выбрасывать исключения при ошибке.

Когда передано значение false, экземпляр SQLite3 и экземпляры SQLite3Stmt и SQLite3Result, производные от него, будут генерировать предупреждения при ошибке.

В любом случае, код ошибки и сообщение, если они есть, будут доступны через SQLite3::lastErrorCode() и SQLite3::lastErrorMsg() соответственно.

Возвращаемые значения

Возвращает старое значение; true, если исключения включены, false в противном случае.

Примеры

Пример #1 Пример использования SQLite3::enableExceptions()


<?php
$sqlite = new SQLite3(':memory:');
try {
    $sqlite->exec('create table foo');
    $sqlite->enableExceptions(true);
    $sqlite->exec('create table bar');
} catch (Exception $e) {
    echo 'Поймано исключение: ' . $e->getMessage();
}
?>

Результатом выполнения данного примера будет что-то подобное:

Warning: SQLite3::exec(): near "foo": syntax error in example.php on line 4
Поймано исключение: near "bar": syntax error

add a note

User Contributed Notes 1 note

down

Yoann ¶

5 years ago


Be sure to note the poorly chosen name and default value.

The following snippet does not throw an exception, despite calling a function with the name "enableExceptions" immediately prior to the bad query.
<?php
$sqlite = new SQLite3('test.tmp');
$sqlite->enableExceptions();
$sqlite->exec('invalid query');
echo 'code still running since no exception was thrown';
?>

Note that this is still error-prone if the passed value is false. One is likely to read "enableExceptions" and ignore the parameter list since the function name conveys a strong (but incorrect) meaning.

add a note