oci_pconnect
(PHP 5, PECL oci8 >= 1.1.0)
oci_pconnect — Ouvre une connexion persistante � un serveur Oracle
Description
Ouvre une connexion persistante � un serveur Oracle et s'identifie.
Les connexions persistantes sont mises en cache et sont r�utilis�es entre les requ�tes, r�duisant ainsi la charge � chaque chargement de la page ; une application PHP typique a une seule connexion persistante � un serveur Oracle par processus enfant Apache (ou processus PHP FastCGI/CGI). Voir la section sur les connexions persistantes aux bases de donn�es pour plus d'informations.
Liste de param�tres
- username
-
Le nom d'utilisateur Oracle.
- password
-
Le mot de passe de l'utilisateur.
- db
-
Peut contenir l'instance locale d'Oracle ou un nom disponible dans le fichier tnsnames.ora.
S'il n'est pas fourni, PHP va chercher la valeur dans les variables d'environnement ORACLE_SID et TWO_TASK pour d�terminer le nom de l'instance locale d'Oracle, et la localisation du fichier tnsnames.ora.
- charset
-
Si vous utilisez un serveur Oracle version 9.2 et suivant, vous pouvez renseigner le param�tre charset , qui peut �tre utilis� dans la nouvelle connexion. Si vous utilisez un serveur Oracle inf�rieur � la version 9.2, ce param�tre sera ignor� et la variable d'environnement NLS_LANG sera utilis�e � la place.
- session_mode
-
Ce param�tre est disponible depuis la version 1.1 et accepte les valeurs suivantes : OCI_DEFAULT, OCI_SYSOPER et OCI_SYSDBA. Si OCI_SYSOPER ou OCI_SYSDBA sont sp�cifi�s, oci_connect() tentera d'�tablir une connexion privil�gi�e en utilisant les droits externes. Les connexions privil�gi�es sont d�sactiv�es par d�faut. Pour les activer, vous devez d�finir oci8.privileged_connect � On.
Valeurs de retour
Retourne un identifiant de connexion, ou FALSE si une erreur survient.
Notes
Note: Depuis la version 1.1 de l'extension oci8, la dur�e de vie ainsi que le nombre maximal de connexions persistantes Oracle peuvent �tre affin�s en d�finissant les valeurs de configuration suivantes : oci8.persistent_timeout, oci8.ping_interval et oci8.max_persistent.
Note: Si vous utilisez PHP avec le client Oracle Instant, vous pouvez utiliser les m�thodes de nommage pour faciliter la connexion tel que d�crites ici : » http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306. En fait, cela signifie que vous pouvez sp�cifier "//db_host[:port]/database_name" en tant que nom de base de donn�es. Mais si vous voulez utiliser l'ancienne m�thode de nommage, vous devez d�finir soit ORACLE_HOME, soit TNS_ADMIN.
Note: Dans les versions de PHP ant�rieures � la version 5.0.0, vous devez utiliser la fonction ociplogon(). Cet ancien nom est toujours utilisable : un alias a �t� fait vers la fonction oci_pconnect(), pour assurer la compatibilit� ascendante. Toutefois, il est recommand� de ne plus l'utiliser.
Voir aussi
- oci_connect() - �tablit une connexion avec un serveur Oracle
- oci_new_connect() - �tablit une nouvelle connexion au serveur Oracle