Öffnet eine persistente Verbindung zum MySQL-Server

# mysql_pconnect

(PHP 4, PHP 5)

mysql_pconnect — Öffnet eine persistente Verbindung zum MySQL-Server

Warnung

Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt. Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL. Weitere Informationen bietet der Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:

- mysqli_connect() mit `p:` Host-Präfix
- PDO::__construct() mit `PDO::ATTR_PERSISTENT` als Treiberoption

### Beschreibung

function mysql_pconnect(
string `$server` = ini_get("mysql.default_host"),
string `$username` = ini_get("mysql.default_user"),
string `$password` = ini_get("mysql.default_password"),
int `$client_flags` = 0
): resource

Baut eine persistente Verbindung zu einem MySQL-Server auf.

mysql_pconnect() verhält sich weitgehend wie mysql_connect() mit zwei großen Unterschieden.

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ückgegeben statt 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).

Deshalb wird dieser Verbindungstyp "persistent" genannt.

### Parameter-Liste

`server`
  Der MySQL-Server. Er kann zudem eine Portnummer enthalten, z. B. "hostname:port" oder den Pfad zu einem lokalen Socket z. B. ":/pfad/zum/socket" für Zugriffe auf dem lokalen Rechner (localhost). Wenn die PHP-Direktive mysql.default_host nicht definiert ist (Standard), ist der Vorgabewert "localhost:3306".
`username`
  Der Benutzername. Der Standardwert ist der Name des Benutzers, dem der Prozess gehört.
`password`
  Das Passwort. Der Standardwert ist ein leeres Passwort.
`client_flags`
  Der Parameter `client_flags` kann eine Kombination der folgenden Konstanten sein: 128 (aktiviert die Verwendung von `LOAD DATA LOCAL`), `MYSQL_CLIENT_SSL`, `MYSQL_CLIENT_COMPRESS`, `MYSQL_CLIENT_IGNORE_SPACE` und `MYSQL_CLIENT_INTERACTIVE`.

### Rückgabewerte

Gibt im Erfolgsfall eine persitente MySQL-Verbindungskennung zurück. Bei einem Fehler wird `false` zurückgegeben.

### Anmerkungen

> Hinweis: Beachten Sie, dass diese Art der Verbindung nur funktioniert. wenn Sie PHP als Modul-Version verwenden. 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.

### Siehe auch

- mysql_connect() - Öffnet eine Verbindung zu einem MySQL-Server
- Persistente Datenbankverbindungen

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open