mysql_pconnect

(PHP 4, PHP 5)

mysql_pconnect — Ouvre une connexion persistante � un serveur MySQL

Description

resource mysql_pconnect ([ string $server= ini_get("mysql.default_host") [, string $username= ini_get("mysql.default_user") [, string $password= ini_get("mysql.default_password") [, int $client_flags ]]]] )

Ouvre une connexion persistante � un serveur MySQL.

mysql_pconnect() se comporte exactement comme mysql_connect(), mais avec deux diff�rences majeures :

Premi�rement, lors de la connexion, la fonction essaie de trouver une connexion permanente d�j� ouverte sur cet h�te, avec le m�me nom d'utilisateur et de mot de passe. Si une telle connexion est trouv�e, son identifiant est retourn�, sans ouvrir de nouvelle connexion.

Deuxi�mement, la connexion au serveur MySQL ne sera pas termin�e avec la fin du script. Au lieu de cela, le lien sera conserv� pour un prochain acc�s (mysql_close() ne terminera pas une connexion persistante �tablie par mysql_pconnect()).

C'est pourquoi ce type de connexion est dite persistante.

Liste de param�tres

server

Le serveur MySQL. Il peut �galement comprendre un num�ro de port, e.g. "hostname:port" ou un chemin vers un socket local e.g. ":/path/to/socket".

Si la directive PHP mysql.default_host n'est pas d�finie (d�faut), alors, la valeur par d�faut est "localhost:3306".

username

Le nom de l'utilisateur. La valeur par d�faut est l'utilisateur faisant fonctionner le processus serveur courant.

password

Le mot de passe. La valeur par d�faut est un mot de passe vide.

client_flags

Le param�tre client_flags peut �tre une compilation des constantes suivantes : 128 (active le gestionnaire LOAD DATA LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE ou MYSQL_CLIENT_INTERACTIVE.

Valeurs de retour

Retourne un identifiant de lien persistant MySQL en cas de succ�s, ou FALSE si une erreur survient.

Historique

Version Description
4.3.0 Ajout du param�tre client_flags .

Notes

Note: Notez que les connexions persistantes ne fonctionnent que si vous utilisez PHP en version module. Lisez la section sur les connexions persistantes aux bases de donn�es pour plus d'informations.

Avertissement

L'utilisation des connexions persistantes requiert des param�trages d'Apache et de MySQL pour vous assurer que vous n'atteindrez pas la limite maximale de nombre de connexions simultan�es autoris�e par MySQL.

Note: Vous pouvez supprimer les messages d'erreur en ajoutant un @ au nom de la fonction.

Voir aussi

Fonctions MySQL
PHP Manual