mysql_fetch_assoc
(PHP 4 >= 4.0.3, PHP 5)
mysql_fetch_assoc — Liefert einen Datensatz als assoziatives Array
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 finden Sie im Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:
Beschreibung
$result): arrayGibt ein assoziatives Array zurück, das dem geholten Datensatz entspricht und bewegt den internen Datenzeiger vorwärts. mysql_fetch_assoc() entspricht in der Funktionsweise exakt dem Aufruf von mysql_fetch_array() mit Angabe von MYSQL_ASSOC als optionalen zweiten Parameter. Sie gibt nur ein assoziatives Array zurück.
Parameter-Liste
-
Ergebnis -
Das Ergebnis Ressource, das ausgewertet wird. Dieses Ergebnis kommt von einem Aufruf von mysql_query().
Rückgabewerte
Gibt ein Array von Zeichenketten zurück, das dem gelesenen Datensatz
entspricht oder false falls keine weiteren Datensätze vorhanden sind.
Falls zwei oder mehrere Felder des Ergebnisses den gleichen Feldnamen haben, dann wird nur der Wert des letzten Felds im Array unter diesem Feldnamen abgelegt. Um auch auf die anderen, gleichnamigen, Felder zugreifen zu können, müssen Sie entweder numerische Indizes und damit mysql_fetch_row() verwenden, oder Aliase für Ihre Felder anlegen. Zur Verwendung von Aliasen schauen Sie sich das Beispiel unter der Beschreibung von mysql_fetch_array() an.
Beispiele
Beispiel #1 Ein ausführliches mysql_fetch_assoc()-Beispiel
<?php
$conn = mysql_connect("localhost", "mysql_user", "mysql_password");
if (!$conn) {
echo "Keine Verbindung zu DB möglich: " . mysql_error();
exit;
}
if (!mysql_select_db("mydbname")) {
echo "Konnte mydbname nicht auswählen: " . mysql_error();
exit;
}
$sql = "SELECT id as userid, fullname, userstatus
FROM sometable
WHERE userstatus = 1";
$result = mysql_query($sql);
if (!$result) {
echo "Konnte Abfrage ($sql) aus DB nicht erfolgreich ausführen: " . mysql_error();
exit;
}
if (mysql_num_rows($result) == 0) {
echo "Keine Zeilen gefunden, nichts auszugeben, also Ende";
exit;
}
// Solange eine Zeile mit Daten vorhanden ist, schreibe diese Zeile in $row
// als assoziatives Array
// Hinweis: Wenn Sie nur eine Ergebniszeile erwarten, benötigen Sie keine Schleife
// Hinweis: Wenn Sie extract($row) innerhalb dieser Schleife schreiben,
// erzeugen Sie $userid, $fullname und $userstatus
while ($row = mysql_fetch_assoc($result)) {
echo $row["userid"];
echo $row["fullname"];
echo $row["userstatus"];
}
mysql_free_result($result);
?>
Anmerkungen
Hinweis: Performance
Zu betonen ist, dass die Verwendung von mysql_fetch_array() nicht signifikant langsamer ist als mysql_fetch_row(), obwohl die Funktion einen sichtlichen Mehrwert bietet.
Hinweis: Feldnamen, die von dieser Funktion zurückgegeben werden, unterscheiden sich in der Groß-/Kleinschreibung.
Hinweis: Diese Funktion setzt NULL-Felder auf den PHP Wert-
null.
Siehe auch
- mysql_fetch_row() - Liefert einen Datensatz als indiziertes Array
- mysql_fetch_array() - Liefert einen Datensatz als assoziatives Array, als numerisches Array oder beides
- mysql_data_seek() - Bewegt den internen Ergebnis-Zeiger
- mysql_query() - Sendet eine Abfrage an MySQL
- mysql_error() - Liefert den Fehlertext der zuvor ausgeführten MySQL-Operation
