Manuel PHP
Précédent |  | Suivant

# sqlite_exec

(PHP 5)

sqlite_exec

(no version information, might be only in CVS)

SQLiteDatabase->exec -- Exécute une requête sans résultats sur une base de données

## Description

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

Style orienté objet (méthode)

class SQLiteDatabase {
bool queryExec ( string 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`.

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.

`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()
sqlite_unbuffered_query()
sqlite_array_query()

Précédent | Sommaire | Suivant
sqlite_escape_string | Niveau supérieur | sqlite_factory