mssql_pconnect

(PHP 4, PHP 5, PECL odbtp >= 1.1.1)

mssql_pconnectOuvre une connexion persistante � un serveur MS SQL

Description

resource mssql_pconnect ([ string $servername [, string $username [, string $password [, bool $new_link ]]]] )

mssql_pconnect() se comporte comme mssql_connect() mais avec deux diff�rences :

Premi�rement, lors de la connexion, la fonction va commencer par rechercher un lien persistant d�j� ouvert avec le m�me h�te, le m�me nom d'utilisateur, username et le m�me mot de passe password . Si un tel lien est trouv�, cet identifiant sera retourn�, au lieu d'ouvrir une autre connexion.

Deuxi�mement, la connexion au serveur SQL ne sera pas ferm�e � la fin du script, mais restera ouverte, pour d'autres utilisations ult�rieures (mssql_close() ne fermera pas un lien �tabli avec mssql_pconnect()).

C'est pourquoi ce type de lien est dit 'persistant'.

Liste de param�tres

servername

Le serveur MS SQL. Il peut �galement contenir un num�ro de port, e.g. hostname:port.

username

Le nom d'utilisateur

password

Le mot de passe

new_link

Si un deuxi�me appel est fait � mssql_pconnect() avec les m�mes arguments, un nouveau lien ne sera pas retourn�, mais le lien d�j� ouvert sera utilis�. Ce param�tre modifie ce comportement et fait que la fonction mssql_pconnect() ouvre toujours un nouveau lien, m�me si la fonction mssql_pconnect() a �t� appel�e avant, avec les m�mes param�tres.

Valeurs de retour

Retourne un identifiant de lien positif MS SQL en cas de succ�s, ou FALSE si une erreur survient.

Exemples

Exemple #1 mssql_pconnect() et le param�tre new_link

<?php
// Connexion au serveur de base de donn�es
$link1 mssql_pconnect('MANGO\SQLEXPRESS''sa''phpfi');
mssql_select_db('php'$link1);

// Cr�ation d'une nouvelle connexion
$link2 mssql_pconnect('MANGO\SQLEXPRESS''sa''phpfi'true);
mssql_select_db('random'$link2);
?>