Einführung

Diese Funktionen erlauben den Zugriff auf einen MySQL Datenbank-Server. Weitere Information zu MySQL sind unter http://www.mysql.com/ erhältlich.

Die Dokumentation zu MySQL ist unter http://dev.mysql.com/doc/ zu finden.

Anforderungen

Um diese Funktionen nutzen zu können, müssen Sie PHP mit MySQL-Unterstützung übersetzen.

Installation

Durch die Angabe der Konfigurationsoption --with-mysql[=DIR] ermöglichen Sie PHPden Zugriff auf MySQL Datenbanken.

Seit PHP 4 ist --with-mysql im Standard aktiviert. Um PHP ohne MySQL Unterstützung zu kompilieren müssen Sie --without-mysql verwenden. Ebenfalls für PHP 4 gilt: falls Sie mit MySQL Unterstützung kompilieren und den Pfad zum Quellverzeichnis von MySQL (DIR) nicht angeben, verwendet PHP die internen MySQL-Client Bibliotheken. Unter Windows gibt es keine DLL, die Unterstützung für MySQL ist in PHP 4 enthalten. Verwenden Sie andere Anwendungen, die MySQL ebenfalls nutzen (zum Beispiel auth-mysql) sollten Sie nicht die interne Bibliothek benutzen, sondern den Pfad zum MySQL Installationsverzeichnis wie folgt angeben: --with-mysql=/pfad/zu/mysql. Diese Angabe zwingt PHP die Client-Bibliotheken zu nutzen, die von MySQL installiert wurden. Diese Vorgehensweise vermeidet jegliche Konflikte.

In PHP 5 ist MySQL weder standardmäßig aktiviert, noch ist die MySQL Client Bibliothek in PHP enthalten. Die Gründe und weitere Details lesen Sie bitte in der FAQ nach. Aus diesem Grund müssen Benutzer von Windows php_mysql.dll in der php.ini aktivieren und die benötigte Bibliothek libmysql.dll entweder in das Windows Systemverzeichnis kopieren oder für die Umgebungsvariable PATH verfügbar machen. Beim kompilieren benutzen Sie einfach --with-mysql=[DIR], wobei [DIR] auf das Installationsverzeichnis von MySQL verweist.

Diese MySQL Erweiterung unterstützt nicht die volle Funktionalität von MySQL Versionen höher als 4.1.0. Um die volle Funktionalität dieser Versionen zu nutzen benutzen Sie die MySQLi Erweiterung.

Falls Sie sowohl die Mysql als auch die MySQLi Erweiterung parallel installieren wollen, müssen Sie die gleiche Client-Bibliothek benutzen um jegliche Konflikte zu vermeiden.

Laufzeit Konfiguration

Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.

Hier eine kurze Erklärung der Konfigurationsoptionen:

Resource Typen

Innerhalb des MySQL-Moduls werden zwei Resourcetypen benutzt. Der erste ist die Verbindungskennung für eine Verbindung zum Datenbankserver, der zweite Typ ist eine Resource die auf das Ergebnis einer Anfrage/Abfrage verweist.

Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

Ab PHP 4.3.0 ist es möglich zusätzliche Client-Flags bei den Funktionen mysql_connect() und mysql_pconnect() anzugeben. Die folgenden Konstanten sind definiert:

Die Funktion mysql_fetch_array() verwendet eine Konstante für die verschiedenen Arten der Ergebnisarrays. Die folgenden Konstanten sind definiert:

Begriffserläuterung

In diesem Dokument wird eine Reihe von Begriffen benutzt, die hier kurz erläutert werden sollen.

Beispiele

Folgendes einfache Beispiel zeigt Ihnen, wie Sie sich mit einer MySQL- Datenbank verbinden, eine Anfrage ausführen, die Ergebnisse ausgeben und die Verbindung wieder trennen.

Beispiel 1. MySQL Erweiterung: ein Überblicks Beispiel <?php /* Verbindung aufbauen, auswählen einer Datenbank */ $link = mysql_connect("mysql_host", "mysql_user", "mysql_password")     or die("Keine Verbindung möglich: " . mysql_error()); echo "Verbindung zum Datenbankserver erfolgreich"; mysql_select_db("Meine_Datenbank") or die("Auswahl der Datenbank fehlgeschlagen"); /* ausführen einer SQL Anfrage */ $query = "SELECT * FROM Meine_Tabelle"; $result = mysql_query($query) or die("Anfrage fehlgeschlagen: " . mysql_error()); /* Ausgabe der Ergebnisse in HTML */ echo "<table>\n"; while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {     echo "\t<tr>\n";     foreach ($line as $col_value) {         echo "\t\t<td>$col_value</td>\n";     }     echo "\t</tr>\n"; } echo "</table>\n"; /* Freigeben des Resultsets */ mysql_free_result($result); /* schliessen der Verbinung */ mysql_close($link); ?>