sqlite_exec
SQLiteDatabase->exec
(No version information available, might be only in CVS)
SQLiteDatabase->exec — Exécute une requête sans résultats sur une base de données
Description
Style orienté objet (méthode)
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.
- 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
Example#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);
}
?>
Example#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();
}
?>