(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
$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.
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
dbhandleest le premier dans la fonction.
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.
| Version | Description |
|---|---|
| 5.1.0 |
Ajout du paramètre error_msg
|
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();
}
?>