mysql_connect

(PHP 3 <= 3.0.18, PHP 4 >= 4.0.0)

mysql_connect -- Öffnet eine Verbindung zu einem MySQL-Server

Beschreibung

resource mysql_connect ([string Server [, string Benutzername [, string Benutzerkennwort]]])

Rückgabewert: Eine MySQL Verbindungs-Kennung im Erfolgsfall oder FALSE im Fehlerfall.

mysql_connect() öffnet eine Verbindung zu einem MySQL Server. 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 Server kann zudem die Portnummer enthalten, z.B. "hostname:port" oder den Pfad zu einem Socket z.B. ":/pfad/zum/socket" für Zugriffe auf dem lokalen Rechner.

Anmerkung: Unterstützung für ":port" wurde in PHP 3.0.10 hinzugefügt.

Unterstützung für "::/pfad/zum/socket" wurde in PHP 3.0.10 hinzugefügt.

Eine Fehlermeldung beim Verbindungsaufbau kann unterdrückt werden, wenn dem Funktionsnamen ein '@' voran gestellt wird.

Für den Fall, dass ein zweiter Aufruf von mysql_connect() mit den gleichen Argumenten erfolgt, wird keine neue Verbindung aufgebaut, sondern die Verbindungs-Kennung der schon bestehenden Verbindung zurückgeliefert.

Die Verbindung zum Datenbank-Server wird geschlossen, sobald die Ausführung des PHP-Skripts beendet ist oder vorher explizit die Funktion mysql_close() aufgerufen wird.

Beispiel 1. Verbindung zum Datenbanksserver öffnen

<?php
    $link = mysql_connect ("localhost", "marliesle", "secret")
        or die ("keine Verbindung möglich");
    print ("Verbindung erfolgreich");
    mysql_close ($link);
?>

Siehe auch mysql_pconnect() und mysql_close().