Forum und email

mysql_connect

(PHP 4, PHP 5, PECL mysql:1.0)

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 lokalen Socket z.B. ":/pfad/zum/socket" für Zugriffe auf dem lokalen Rechner (localhost).

Hinweis: Immer, wenn Sie als Server "localhost" oder "localhost:port" angeben, wird die MySQL Client Bibiliothek diese Angabe überschreiben und versuchen eine Verbindung zu einem lokalen Socket (named pipe für Windows) aufzubauen. Wenn Sie TCP/IP benutzen wollen, müssen Sie die Angabe "127.0.0.1" statt "localhost" benutzen. Falls die MySQL client Bibliothek versucht die Verbindung zu einem falschen Socket aufzubauen, sollten Sie den korrekten Pfad als mysql_default_host in Ihrer PHP Konfiguration angeben und die Angabe für Server leer lassen.
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_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE oder MYSQL_CLIENT_INTERACTIVE sein.

Hinweis: Der Parameter neue_Verbindung steht seit PHP 4.2.0 zur Verfügung.
Der 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.

Example#1 Verbindung zum Datenbanksserver öffnen

<?php
$link 
mysql_connect('localhost''mysql_user''mysql_password');
if (!
$link) {
    die(
'keine Verbindung möglich: ' mysql_error());
}
echo 
'Verbindung erfolgreich';
mysql_close($link);
?>

Siehe auch mysql_pconnect() und mysql_close().