oci_pconnect

(PHP 5)

oci_pconnect -- Ouvre une connexion persistante à un serveur Oracle

Description

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

oci_pconnect() crée une nouvelle connexion persistante à un serveur Oracle, et s'identifie avec le nom d'utilisateur username et le mot de passe password. Le troisième paramètre, optionnel, db peut contenir l'instance locale d'Oracle ou un nom disponible dans le fichier tnsnames.ora. Si le troisième paramètre 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.

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é à la place.

oci_pconnect() retourne une ressource de connexion Oracle en cas de succès, et sinon, FALSE.

Note : Notez que les connexions persistantes ne fonctionnent que si vous utiliser une version module de PHP. Voyez la section connexions persistantes pour plus d'informations.

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() et oci_new_connect().