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