8.124 Fonctions SQLite
8 Référence des fonctions
Manuel PHP
. Introduction
. Installation
. Pré-requis
. Types de ressources
. Constantes pré-définies
. Classes pré-définies
. Configuration à l'exécution
. sqlite_array_query
. sqlite_busy_timeout
. sqlite_changes
. sqlite_close
. sqlite_column
. sqlite_create_aggregate
. sqlite_create_function
. sqlite_current
. sqlite_error_string
. sqlite_escape_string
. sqlite_exec
. sqlite_factory
. sqlite_fetch_all
. sqlite_fetch_array
. sqlite_fetch_column_types
. sqlite_fetch_object
. sqlite_fetch_single
. sqlite_fetch_string
. sqlite_field_name
. sqlite_has_more
. sqlite_has_prev
. sqlite_key
. sqlite_last_error
. sqlite_last_insert_rowid
. sqlite_libencoding
. sqlite_libversion
. sqlite_next
. sqlite_num_fields
. sqlite_num_rows
. sqlite_open
. sqlite_popen
. sqlite_prev
->sqlite_query
. sqlite_rewind
. sqlite_seek
. sqlite_single_query
. sqlite_udf_decode_binary
. sqlite_udf_encode_binary
. sqlite_unbuffered_query
. sqlite_valid
|
8.124.40 sqlite_query()SQLiteDatabase->query()Exécute une requête SQLite et lit le résultat[ Exemples avec sqlite_query ] PHP 5
resource
sqlite_query (
resource
dbhandle
,
string
query
,
int
result_type
,
string
error_msg
)
resource
sqlite_query (
string
query
,
resource
dbhandle
,
int
result_type
,
string
error_msg
)
Style orienté objet (méthode)
SQLiteDatabase
SQLiteResult
query (
string
query
,
int
result_type
,
string
error_msg
)
Exécute la requête SQL
query
dans une base SQLite.
-
dbhandle
-
La ressource de base de données SQLite; retournée par
sqlite_open
lorsqu'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.
-
result_type
- Le paramètre optionnel
result_type
accepte une constante et détermine comment
le tableau retourné doit être indexé. L'utilisation de
SQLITE_ASSOC
retournera uniquement un tableau associatif
(nom des champs) tandis que
SQLITE_NUM
retournera un
tableau indexé numériquement (numéro ordinal des champs).
SQLITE_BOTH
retournera des indices numériques et associatifs.
SQLITE_BOTH
est la valeur par défaut pour cette
fonction.
-
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.
|
Retourne une ressource de résultat ou
FALSE
en cas d'échec.
Pour les requêtes qui retournent des lignes, la ressource de résultat
peut être utilisée avec les fonctions comme
sqlite_fetch_array
et
sqlite_seek
.
Indépendamment du type, cette fonction retournera
FALSE
si la
requête échoue.
sqlite_query
retourne un résultat bufférisé.
C'est très pratique pour des résultats de petite taille, où vous
aurez besoin d'accéder aléatoirement aux lignes. Les résultats
bufférisés allouent la mémoire nécessaire pour stocker tout le
résultat, et ne se termineront qu'une fois toutes ces données
lues. Si vous n'avez besoin que d'un accès séquentiel aux
données, il est recommandé d'utiliser
sqlite_unbuffered_query
.
| Version |
Description |
| 5.1.0 |
Ajout du paramètre
error_msg
|
| Attention | |
SQLite
va
exécute les requêtes multiples, séparées par
des points-virgules, ce qui vous permet d'exécuter plusieurs requêtes SQL
en une seule fois.
Lorsque vous exécutez des requêtes multiples, la valeur retournée
par cette fonction sera
FALSE
si une erreur s'est produite, mais
indéfini dans les autres cas (cela peut être
TRUE
en cas de
succès, ou bien elle peut retourner un résultat).
|
|
