PHP Handbuch
Zurück |  | Nach vorne

# mysql_pconnect

(PHP 3, PHP 4 )

mysql_pconnect -- Öffnet eine persistente Verbindung zum MySQL Server

## Beschreibung

resource mysql_pconnect ( [string Server [, string Benutztername [, string Benutzerkennwort [, int client_flags]]]])

Rückgabewert: Eine positive, MySQL-persistente Verbindungs-Kennung im Erfolgsfall oder `FALSE` im Fehlerfall.

mysql_pconnect() baut eine Verbindung zu einem MySQL Server auf. Für fehlende optionale Parameter werden folgende Standardwerte angenommen: `Server` = 'localhost:3306', `Benutzername` = Name des Benutzers dem der Server-Prozess gehört und `Benutzerkennwort` = leeres Kennwort. Der Parameter `client_flags` kann eine Kombination der Konstanten MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE oder MYSQL_CLIENT_INTERACTIVE sein.

Der Parameter `Server` kann ausserdem eine Portnummer enthalten, z.B. "hostname:port" oder den Pfad zu einem Socket z.B. ":/pfad/zu/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 ":/pfad/zum/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 offene (persistente) Verbindung zum gleichen Host, mit dem gleichen Benutzernamen und Benutzerkennwort zu finden. Wenn das gelingt, wird die Verbindungskennung dieser Verbindung zurückgeliefert anstatt eine neue Verbindung aufzubauen.

Zweitens: die Verbindung zum SQL Server wird beim Beenden des PHP-Skripts nicht geschlossen. Sie bleibt zur zukünftigen Verwendung bestehen. (mysql_close() schließt keine von mysql_pconnect() geöffneten Verbindungen).

Der optionale Parameter `client_flags` steht seit PHP 4.3.0 zur Verfügung.

Deshalb wird dieser Verbindungstyp 'persistent' genannt.

> Anmerkung: Beachten Sie, dass diese Art der Verbindung nur funktioniert. wenn Sie PHP als Modul-Version benutzen. Für mehr Informationen schauen Sie unter Persistente Datenbankverbindungen nach.

Warnung
Die Verwendung von persistenten Verbindungen verlangt unter Umständen eine feinere Abstimmung der Konfiguration von Apache und MySQL. Dadurch sollten Sie sicherstellen, dass Sie die Anzahl der Verbindungen, die MySQL maximal erlaubt, nicht überschreiten.

Zurück | Zum Anfang | Nach vorne
mysql_num_rows | Nach oben | mysql_ping