Retourne une connexion persistante à une base de données IBM DB2
Universal Database, IBM Cloudscape ou Apache Derby. Pour plus
d'informations sur les connexions persistantes, référez-vous Ã
Chapitre 41.
En appelant db2_close() sur une connexion persistante,
vous recevrez toujours TRUE, mais les connexions des clients DB2
demeureront ouvertes et attendront de servir la prochaine demande de la
fonction db2_pconnect().
Liste de paramètres
database
L'alias de la base de données dans le catalogue du client DB2.
username
Le nom d'utilisateur avec lequel vous vous connectez à la base de
données.
password
Le mot de passe avec lequel vous vous connectez à la base de données.
options
Un tableau associatif des options de connexion qui affecteront le
comportement de la connexion, où les valeurs des clés incluent :
autocommit
La valeur DB2_AUTOCOMMIT_ON active le autocommit
sur cette connexion.
La valeur DB2_AUTOCOMMIT_OFF désactive le
autocommit pour cette connexion.
DB2_ATTR_CASE
Passer la valeur DB2_CASE_NATURAL spécifie que les
noms de colonnes seront retournés dans leurs casses naturelles.
Passer la valeur DB2_CASE_LOWER spécifie que les
noms de colonnes seront retournés en minuscule.
Passer la valeur DB2_CASE_UPPER spécifie que les
noms de colonnes seront retournés en majuscule.
CURSOR
Passer la valeur DB2_FORWARD_ONLY spécifie un curseur
uniquement suivant pour une ressource de requête. C'est le type de curseur
par défaut et est supporté sur tous les serveurs de base de données.
Passer la valeur DB2_SCROLLABLE spécifie un
curseur scrollable pour une ressource de requête. Ce mode permet
un accès aléatoire aux lignes dans un jeu de résultats, mais actuellement,
n'est supporté que par la base de données IBM DB2 Universal.
Valeurs de retour
Retourne la ressource de connexion si la tentative de connexion réussie.
db2_pconnect() essaie de réutiliser une ressource de
connexion existante qui correspond parfaitement aux paramètres tels que la base de données
database, l'utilisateur username
et le mot de passe password. Si la tentative de
connexion échoue, db2_pconnect() retourne FALSE
Exemples
Exemple 1. Exemple d'utilisation de db2_pconnect()
Dans l'exemple suivant, le premier appel Ã
db2_pconnect() retourne une nouvelle ressource de
connexion persistante. Le second appel à la fonction
db2_pconnect() retourne une ressource de connexion
persistante qui réutilise la première ressource de connexion.
