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.
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
Version en cache
22/11/2024 05:27:38 Cette version de la page est en cache (à la date du 22/11/2024 05:27:38) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.sqlite-exec.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.