SQLite3::enableExceptions

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

SQLite3::enableExceptions Activa el lanzamiento de excepciones

Descripción

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

Controla si la instancia SQLite3 lanzará excepciones o advertencias en caso de error.

Parámetros

enable

Si true, la instancia SQLite3, y las instancias derivadas de SQLite3Stmt y SQLite3Result, lanzarán excepciones en caso de errores.

Si false, la instancia SQLite3, y las instancias derivadas de SQLite3Stmt y SQLite3Result, lanzarán advertencias en caso de errores.

Para cada uno de los modos, el código y mensaje de error, si los hay, estarán disponibles gracias a SQLite3::lastErrorCode() y SQLite3::lastErrorMsg() respectivamente.

Valores devueltos

Devuelve el valor anterior; true si las excepciones estaban activadas, false en caso contrario.

Historial de cambios

Versión Descripción
8.3.0 Llamar a SQLite3::enableExceptions() con enable a false desencadenará una advertencia E_DEPRECATED.

Ejemplos

Ejemplo #1 Ejemplo con 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
'Caught exception: ' . $e->getMessage();
}
?>

El resultado del ejemplo sería algo similar a:

Warning: SQLite3::exec(): near "foo": syntax error in example.php on line 4
Caught exception: near "bar": syntax error