sqlite_exec
SQLiteDatabase::exec
(PHP 5 < 5.4.0, PECL sqlite >= 1.0.3)
sqlite_exec -- SQLiteDatabase::exec — Exécute une requête sans résultats sur une base de données
Description
$dbhandle
, string $query
[, string &$error_msg
] )$query
, resource $dbhandle
)Style orienté objet (méthode) :
$query
[, string &$error_msg
] )
sqlite_exec() exécute une requête SQL query
sur une base de données spécifiée par la ressource dbhandle
.
SQLite doit exécuter de multiples requêtes séparées par des points-virgules ; vous pouvez donc l'utiliser pour exécuter un script SQL que vous avez chargé depuis un fichier ou que vous avez intégré dans un script.
Liste de paramètres
-
dbhandle
-
La ressource de base de données SQLite; retournée par sqlite_open() lorsque utilisée de manière procédurale. Ce paramètre n'est pas requis si vous utilisez la méthode orientée objet.
-
query
-
La requête à être exécutée.
Les données contenues dans la requête doivent être échappées.
-
error_msg
-
La variable spécifiée sera remplie si une erreur se produit. Ceci est important car les erreurs de syntaxes SQL ne peuvent être récupérées en utilisant la fonction sqlite_last_error().
Note: Deux syntaxes alternatives sont supportées pour assurer la compatibilité avec les autres bases de données (telles que MySQL) : la forme recommandée est la première, où le paramètre
dbhandle
est le premier dans la fonction.
Valeurs de retour
Cette fonction retourne un résultat booléen; TRUE
en cas de succès,
FALSE
en cas d'erreur.
Si vous avez besoin d'exécuter une requête qui doit retourner des lignes, reportez-vous à
la fonction sqlite_query().
Les noms de colonnes retournés par
SQLITE_ASSOC
et SQLITE_BOTH
suivent les règles concernant la case définie par l'option de configuration
sqlite.assoc_case.
Historique
Version | Description |
---|---|
5.1.0 |
Ajout du paramètre error_msg
|
Exemples
Exemple #1 Style procédural
<?php $dbhandle = sqlite_open('mysqlitedb'); $query = sqlite_exec($dbhandle, "UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error); if (!$query) { exit("Erreur dans la requête : '$error'"); } else { echo 'Nombre de lignes modifiées : ', sqlite_changes($dbhandle); } ?>
Exemple #2 Style orienté objet
<?php
$dbhandle = new SQLiteDatabase('mysqlitedb');
$query = $dbhandle->exec("UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
if (!$query) {
exit("Erreur dans la requête : '$error'");
} else {
echo 'Nombre de lignes modifiées : ', $dbhandle->changes();
}
?>
Voir aussi
- sqlite_query() - Exécute une requête SQLite et lit le résultat
- sqlite_unbuffered_query() - Exécute une requête SQLite non bufferisée
- sqlite_array_query() - Exécute une requête SQL avec SQLite et retourne un tableau