mysql_connect

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

Beschreibung

resource mysql_connect ( [string Server [, string Benutzername [, string Benutzerkennwort [, bool neue_Verbindung [, int client_flags]]]]])

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 PHP 3.0B4 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 . Der Parameter neue_Verbindung beeinflusst dieses Verhalten und mysql_connect( ) öffnet immer eine neue Verbindung , sogar dann , wenn mysql_connect( ) zu einem früheren Zeitpunkt mit den gleichen Parametern aufgerufen wurde . Der Parameter client_flags kann eine Kombination der Konstanten MYSQL_CLIENT_SSL , MYSQL_CLIENT_COMPRESS , MYSQL_CLIENT_IGNORE_SPACE oder MYSQL_CLIENT_INTERACTIVE sein .

Anmerkung : Der Parameter neue_Verbindung steht seit PHP 4.2.0 zur Verfügung .

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

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"

 
,

 
"mysql_user"

 
,

 
"mysql_password"

 
)

 
or

 
die

 
("keine

 
Verbindung

 
möglich

 
:

 
"

 
.mysql_error())

 
;

 
print

 
("Verbindung

 
erfolgreich")

 
;

 
mysql_close

 
($link)

 
;

 
?



Siehe auch mysql_pconnect( ) und mysql_close( ) .