Manuel PHP
Précédent |  | Suivant

# mysql_pconnect

(PHP 3 <= 3.0.18, PHP 4 >= 4.0.0)

mysql_pconnect -- Ouvre une connexion persistante à un serveur MySQL.

## Description

``resource mysql_pconnect` (string [hostname [:port] [:/path/to/socket]] [, string username [, string password]])`

mysql_pconnect() retourne un lien persistant positif en cas de succès et sinon `FALSE` en cas d'erreur.

mysql_pconnect() établit une connexion persistante à un serveur MySQL. Tous les arguments sont optionnels et des valeurs par défaut seront utilisér en cas d'omission ('`localhost`', nom d'utilisateur propriétaire du processus, mot de passe vide).

Le nom de l'hôte peut aussi inclure le numéro de port, c'est-à-dire "hostname:port" ou un chemin jusqu'à la socket `:/path/to/socket` pour l'hôte local.

> Note : Le support de ":port" a été ajouté à partir de la version 3.0B4.

> Le support de ":/path/to/socket" a été ajouté à partir de la version 3.0.10.

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

Précédent | Sommaire | Suivant
mysql_num_rows | Niveau supérieur | mysql_unbuffered_query