oci_pconnect

(PHP 5, PECL oci8 >= 1.1.0)

oci_pconnect — Ouvre une connexion persistante � un serveur Oracle

Description

resource oci_pconnect ( string $username , string $password [, string $db [, string $charset [, int $session_mode ]]] )

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

Fonctions OCI8
PHP Manual