mssql_pconnect
(PHP 4, PHP 5, PECL odbtp >= 1.1.1)
mssql_pconnect — Ouvre une connexion persistante � un serveur MS SQL
Description
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);
?>