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.38 sqlite_popen()
Ouvre une connexion SQlite persistante et crée la base si elle n'existe pas[ Exemples avec sqlite_popen ] PHP 5
resource
sqlite_popen (
string
filename
,
int
mode
,
string
error_message
)
sqlite_popen
fonctionne exactement comme
sqlite_open
, hormis le fait qu'elle utilise le mécanisme
de ressources persistantes de PHP. Pour des détails sur la signification
des paramètres, voyez la fonction
sqlite_open
.
sqlite_popen
va d'abord vérifier qu'il reste une connexion
persistante déjà ouverte pour le fichier
filename
.
Si elle peut en trouver une, elle l'utilisera et, sinon, elle ouvrira une nouvelle connexion.
L'intérêt de cette méthode est que vous évitez de relire la base, les schémas
de tables et d'index, pour chaque page exécutée par un serveur web SAPI
persistant (tous les SAPI, sauf les CGI et CLI).
| Note | |
Si vous utilisez une connexion persistante et que la base de données est
modifiée par un autre processus (via une table de cron, par exemple), et
que le processus recrée la base en l'écrasant, soit par effacement et reconstruction,
ou par déplacement d'une nouvelle version à la place de l'ancienne,
vous pourriez obtenir des comportements inattendus lorsque vous utiliserez
une vielle connexion persistante sur une nouvelle base.
Pour éviter cette situation, faîtes en sorte que vos processus parallèles ouvrent
les bases et fassent leurs modifications dans une transaction.
|
-
filename
-
Le nom du fichier de la base de données SQLite. Si le fichier n'existe
pas, SQLite tentera de le créer. PHP doit avoir les permissions
d'écriture du fichier si des données y sont insérées, le schéma de la
base de données est modifié, ou pour créer une base de données si elle
n'existe pas.
-
mode
-
Le mode du fichier. Devrait être utilisé pour ouvrir une base de
données en mode lecture seule. Actuellement, ce paramètre est ignoré
par la bibliothèque sqlite. La valeur par défaut pour le mode est
0666
en octal : c'est la valeur recommandée.
-
error_message
-
Passée par référence et est affectée afin de contenir la description du
message d'erreur qui explique pourquoi la base de données ne pouvait
pas être ouverte s'il y avait une erreur.
Retourne une ressource (de base de données) en cas de succès,
FALSE
en
cas d'erreur.
|
