Manuel PHP
Précédent |  | Suivant

# mysql_pconnect

(PHP 3, PHP 4 , PHP 5)

mysql_pconnect -- Ouvre une connexion persistante à un serveur MySQL

## Description

resource mysql_pconnect ( [string server [, string username [, string password [, int client_flags]]]] )

mysql_pconnect() retourne un lien persistant positif en cas de succès et `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ées en cas d'omission : server vaudra 'localhost', username sera le nom d'utilisateur propriétaire du processus, password sera le mot de passe vide.

Le nom de l'hôte server 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'.

> Note : Notez que les connexions persitantes ne fonctionnent que si vous utilisez PHP en version module. Voyez 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.

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