(PHP 5 < 5.4.0, PECL sqlite >= 1.0.3)
sqlite_exec -- SQLiteDatabase::exec — Ejecutar una consulta sin resultado en una base de datos dada
$dbhandle
, string $query
[, string &$error_msg
] ) : bool$query
, resource $dbhandle
) : boolEstilo orientado a objetos (método):
$query
[, string &$error_msg
] ) : bool
Ejecuta una sentencia SQL dada por query en
un gestor de base de datos dado (especificado por el parámetro
dbhandle).
SQLite ejecutará múltiples consultas separadas por puntos y comas, por lo que se puede usar esta función para ejecutar un lote de SQL que se haya cargado desde un fichero o embebido en un script.
dbhandleEl recurso de Base de datos de SQLite; devuelto por sqlite_open() cuando se usa procedimentalmente. Este parámetro no es necesario cuando se usa el método orientado a objetos.
queryLa consulta a ejectuar.
Los datos dentro de la consulta deberían ser apropiadamente escapados.
error_msgLa variable especificada será rellenada si ocurre un error. Esto es especialmente importante ya que los errores de sintaxis de SQL no se pueden recoger usando la función sqlite_last_error().
Nota: Dos sintaxis alternativas son soportadas para la compatibilidad con otras extensiones de base de datos (tal como MySQL). La forma preferida es la primera, donde el parámetro
dbhandlees el primero de la función.
Esta función devolverá un resultado booleano; TRUE en caso de éxito o FALSE en caso de error.
Si se necesita ejecutar una consulta que devuelva filas, véase sqlite_query().
Los nombre de las columnas devueltos por
SQLITE_ASSOC y SQLITE_BOTH serán
mayúsculas o no de acuerdo al valor de la opción de configuración
sqlite.assoc_case.
| Versión | Descripción |
|---|---|
| 5.1.0 |
Se añadió el parámetro error_msg
|
Ejemplo #1 Ejemplo procedimental
<?php
$dbhandle = sqlite_open('mysqlitedb');
$query = sqlite_exec($dbhandle, "UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
if (!$query) {
exit("Error en la consulta: '$error'");
} else {
echo 'Número de filas modificadas: ', sqlite_changes($dbhandle);
}
?>
Ejemplo #2 Ejemplo orientado a objetos
<?php
$dbhandle = new SQLiteDatabase('mysqlitedb');
$query = $dbhandle->queryExec("UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
if (!$query) {
exit("Error en la consulta: '$error'");
} else {
echo 'Número de filas modificadas: ', $dbhandle->changes();
}
?>