Exécute une requête sans résultats sur une base de données

# 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

sqlite_exec ( resource `$dbhandle` , string `$query` [, string `&$error_msg` ] ) : bool
sqlite_exec ( string `$query` , resource `$dbhandle` ) : bool

Style orienté objet (méthode) :

public SQLiteDatabase::queryExec ( string `$query` [, string `&$error_msg` ] ) : bool

sqlite_exec() exécute une requête SQL `query` sur une base de données spécifiée par la ressource `dbhandle`.

Avertissement

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