int mysql_pconnect ([string hostname[:port][:/path/to/socket] [, string Benutztername [, string Benutzerkennwort]]])
Rückgabewert: Eine gültige Verbindung-Kennung im Erfolgsfall oder FALSE im Fehlerfall.
mysql_pconnect() baut eine Verbindung zum MySQL Server auf. Alle Argumente sind optional, und wenn alle fehlen wird ('localhost', Benutzername des Benutzers dem der Server-Prozess gehört, leeres Kennwort) angenommen.
Der Parameter hostname kann zudem die Portnummer enthalten, z.B. "hostname:port" oder den Pfad zu einem Socket z.B. ":/path/to/socket" für Zugriffe auf dem lokalen Rechner.
Anmerkung: Unterstützung für ":port" wurde in PHP 3.0B4 hinzugefügt.
Unterstützung für ":/path/to/socket" wurde in PHP 3.0.10 hinzugefügt.
mysql_pconnect() verhält sich sehr ähnlich zu mysql_connect(), weist aber zwei wesentliche Unterschiede auf.
Erstens, vor dem Verbindungsaufbau wird zunächst versucht eine (persistente) Verbindung zum gleichen Host und mit dem gleichen Benutzernamen und Kennwort zu finden. Wenn dies der Fall ist, wird die Verbindungskennung dieser Verbindung zurückgeliefert und keine neue Verbindung geöffnet.
Zweitens, die Verbindung zum SQL Server wird nicht mit Beendigung des PHP-Skripts geschlossen. Sie bleibt bestehen für einen möglichen, zukünftigen Verbindungsaufbau. (mysql_close() schließt keine mit mysql_pconnect() geöffnete Verbindungen).
Dieser Verbindungstyp wird daher 'persistent' genannt.