Manuel PHP
Précédent |  | Suivant

# db2_pconnect

(PECL)

db2_pconnect -- Retourne une connexion persistante à une base de données

## Description

resource db2_pconnect ( string database, string username, string password [, array options] )

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

Notez qu'il est vivement recommandé d'utiliser des connexions persistantes avec la valeur autocommit activée. Si vous essayez de combiner les transactions sur des connexion persistante, l'appel de fonctions db2_commit() ou db2_rollback() contre une connexion persistante affectera chaque connexion persistante qui utilisent les mêmes connexions des clients DB2. Vous devriez aussi rapidement éprouver des blocages de verrous si vous n'utilisez pas autocommit pour des connexions persistantes.

## 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.

## 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.

`<?php
$database = 'EXEMPLE';
$user = 'db2inst1';
$password = 'ibmdb2';
$pconn = db2_pconnect($database, $user, $password);
if ($pconn) {
echo "Connexion persistante réussie.";
}
else {
echo "Connexion persistante échouée.";
}
$pconn2 = db2_pconnect($database, $user, $password);
if ($pconn) {
echo "Deuxième connexion persistante réussie.";
}
else {
echo "Deuxième connexion persistante échouée.";
}
?>`

L'exemple ci-dessus va afficher :

    Connexion persistante réussie.
    Deuxième connexion persistante réussie.

## Voir aussi

db2_connect()

Précédent | Sommaire | Suivant
db2_num_rows | Niveau supérieur | db2_prepare