mysql_pconnect

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 .