SQLite3::setAuthorizer

Descripción

Define una función de retrollamada que será llamada por SQLite cada vez que se realiza una acción (lectura, eliminación, actualización, etc.). Esto se utiliza durante la preparación de una sentencia SQL a partir de una fuente no confiable para asegurarse de que las sentencias SQL no intenten acceder a datos a los que no están autorizadas a acceder, o que no intenten ejecutar sentencias maliciosas que dañen la base de datos. Por ejemplo, una aplicación puede autorizar a un usuario a introducir consultas SQL arbitrarias para evaluación por una base de datos. Pero la aplicación no quiere que el usuario pueda realizar modificaciones arbitrarias en la base de datos. Un autorizador podría entonces establecerse mientras el SQL introducido por el usuario es preparado para prohibir todo excepto las declaraciones SELECT.

La función de retrollamada del autorizador puede ser llamada varias veces para cada sentencia preparada por SQLite. Una consulta SELECT o UPDATE llamará al autorizador para cada columna que sería leída o actualizada.

La función de retrollamada del autorizador es llamada con hasta cinco parámetros. El primer parámetro siempre es proporcionado, y es un int (código de acción) correspondiente a una constante de SQLite3. Los otros parámetros solo se pasan para ciertas acciones. La tabla siguiente describe los parámetros segundo y tercero según la acción:

Lista de códigos de acción y parámetros

Acción	Segundo parámetro	Tercer parámetro
SQLite3::CREATE_INDEX	Nombre del índice	Nombre de la tabla
SQLite3::CREATE_TABLE	Nombre de la tabla	null
SQLite3::CREATE_TEMP_INDEX	Nombre del índice	Nombre de la tabla
SQLite3::CREATE_TEMP_TABLE	Nombre de la tabla	null
SQLite3::CREATE_TEMP_TRIGGER	Nombre del disparador	Nombre de la tabla
SQLite3::CREATE_TEMP_VIEW	Nombre de la vista	null
SQLite3::CREATE_TRIGGER	Nombre del disparador	Nombre de la tabla
SQLite3::CREATE_VIEW	Nombre de la vista	null
SQLite3::DELETE	Nombre de la tabla	null
SQLite3::DROP_INDEX	Nombre del índice	Nombre de la tabla
SQLite3::DROP_TABLE	Nombre de la tabla	null
SQLite3::DROP_TEMP_INDEX	Nombre del índice	Nombre de la tabla
SQLite3::DROP_TEMP_TABLE	Nombre de la tabla	null
SQLite3::DROP_TEMP_TRIGGER	Nombre del disparador	Nombre de la tabla
SQLite3::DROP_TEMP_VIEW	Nombre de la vista	null
SQLite3::DROP_TRIGGER	Nombre del disparador	Nombre de la tabla
SQLite3::DROP_VIEW	Nombre de la vista	null
SQLite3::INSERT	Nombre de la tabla	null
SQLite3::PRAGMA	Nombre Pragma	El primer argumento pasado al pragma, o null
SQLite3::READ	Nombre de la tabla	Nombre de la columna
SQLite3::SELECT	null	null
SQLite3::TRANSACTION	Operación	null
SQLite3::UPDATE	Nombre de la tabla	Nombre de la columna
SQLite3::ATTACH	Filename	null
SQLite3::DETACH	Nombre de la base de datos	null
SQLite3::ALTER_TABLE	Nombre Database	Nombre de la tabla
SQLite3::REINDEX	Nombre del índice	null
SQLite3::ANALYZE	Nombre de la tabla	null
SQLite3::CREATE_VTABLE	Nombre de la tabla	Nombre del módulo
SQLite3::DROP_VTABLE	Nombre de la tabla	Nombre del módulo
SQLite3::FUNCTION	null	Nombre de la función
SQLite3::SAVEPOINT	Operación	Nombre del punto de guardado
SQLite3::RECURSIVE	null	null

El cuarto parámetro será el nombre de la base de datos ("main", "temp", etc.) si es aplicable.

El quinto parámetro de la función de retrollamada del autorizador es el nombre del disparador o de la vista más interno que es responsable del intento de acceso o null si este intento de acceso proviene directamente del código SQL de nivel superior.

Cuando la función de retrollamada devuelve SQLite3::OK, significa que la operación solicitada es aceptada. Cuando la función de retrollamada devuelve SQLite3::DENY, la llamada que provocó el autorizador fallará con un mensaje de error explicando que el acceso es denegado.

Si el código de acción es SQLite3::READ y la función de retrollamada devuelve SQLite3::IGNORE, entonces la sentencia preparada se construye para sustituir un valor null en lugar de la columna de la tabla que se habría leído si SQLite3::OK se hubiera devuelto. Devolver SQLite3::IGNORE puede ser utilizado para denegar a un usuario no confiable el acceso a columnas individuales de una tabla.

Cuando una tabla es referenciada por un SELECT pero no se extrae ningún valor de columna de esa tabla (por ejemplo en una consulta como "SELECT count(*) FROM table"), entonces la función de retrollamada del autorizador se invoca una vez para esa tabla con un nombre de columna que es una cadena vacía.

Si el código de acción es SQLite3::DELETE y la función de retrollamada devuelve SQLite3::IGNORE, entonces la operación DELETE continúa pero la optimización de truncamiento es desactivada y todas las filas se eliminan individualmente.

Solo un autorizador puede estar activo en una conexión de base de datos a la vez. Cada llamada a SQLite3::setAuthorizer() reemplaza la llamada anterior. Desactive el autorizador instalando una retrollamada null. El autorizador está desactivado por omisión.

La función de retrollamada del autorizador no debe hacer nada que modifique la conexión de base de datos que ha invocado la función de retrollamada del autorizador.

Es importante señalar que el autorizador solo se llama cuando una sentencia es preparada, no cuando es ejecutada.

Más detalles pueden encontrarse en la » documentación de SQLite3.

Array
(
    [id] => 1
    [name] => Pauline
    [password] =>
)