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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    16
    Yoann
    6 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
    To Top