mysqli::query
mysqli_query
(PHP 5, PHP 7, PHP 8)
mysqli::query -- mysqli_query — Führt eine Abfrage in einer Datenbank durch
Beschreibung
Objektorientierter Stil
Warnung
Sicherheitswarnung: SQL-Injection
Wenn die Abfrage
irgendwelche Eingabevariablen enthält, sollten stattdessen
parametrisierte Prepared Statements
verwendet werden. Alternativ dazu müssen die Daten korrekt formatiert sein und
alle Strings müssen mit der Funktion
mysqli_real_escape_string() maskiert werden.
Bei Nicht-DML-Abfragen (nicht INSERT, UPDATE oder DELETE) ist diese
Funktion vergleichbar mit dem Aufruf von
mysqli_real_query(), gefolgt entweder von
mysqli_use_result() oder
mysqli_store_result().
Hinweis:
Wenn eine Anweisung an mysqli_query() übergeben wird,
die größer ist als die vom Server maximal erlaubte Paketgröße
(max_allowed_packet), hängen die zurückgegebenen
Fehlercodes davon ab, ob der MySQL Native Driver
(mysqlnd) oder die MySQL Client Library
(libmysqlclient) verwendet wird. Die Funktion verhält
sich wie folgt:
-
mysqlnd gibt unter Linux den Fehlercode 1153 zurück.
Diese Fehlermeldung bedeutet got a packet bigger than
max_allowed_packet bytes
.
-
mysqlnd gibt unter Windows den Fehlercode 2006 zurück.
Diese Fehlermeldung bedeutet server has gone away
.
-
libmysqlclient gibt auf allen Plattformen den
Fehlercode 2006 zurück. Diese Fehlermeldung bedeutet server has
gone away
.
Parameter-Liste
-
mysql Nur bei prozeduralem Aufruf: ein von
mysqli_connect() oder mysqli_init()
zurückgegebenes mysqli-Objekt.
query
-
Die Zeichenkette für die Abfrage
result_mode
-
Der Ergebnismodus kann eine von 3 Konstanten sein, die bestimmen, wie
das Ergebnis vom MySQL-Server zurückgegeben werden soll.
MYSQLI_STORE_RESULT (Standard) - gibt ein
mysqli_result-Objekt mit gepufferter
Ergebnismenge zurück.
MYSQLI_USE_RESULT - gibt ein
mysqli_result-Objekt mit ungepufferter
Ergebnismenge zurück. Solange es noch Datensätze gibt, die darauf
warten, abgerufen zu werden, ist die Verbindung belegt und alle
nachfolgenden Aufrufe geben den Fehler Commands out of
sync zurück. Um den Fehler zu vermeiden, müssen alle
Datensätze vom Server abgeholt werden oder die Ergebnismenge muss durch
den Aufruf von mysqli_free_result() verworfen werden.
MYSQLI_ASYNC (verfügbar mit mysqlnd) - die Abfrage
wird asynchron ausgeführt und die Ergebnismenge wird nicht sofort
zurückgegeben. Um die Ergebnisse solcher Abfragen zu erhalten, wird
dann die Funktion mysqli_poll() benutzt. Dies wird
in Kombination mit einer der Konstanten
MYSQLI_STORE_RESULT oder
MYSQLI_USE_RESULT verwendet.
Rückgabewerte
Gibt bei einem Fehler false zurück. Bei erfolgreichen Abfragen, die eine
Ergebnismenge erzeugen, also z. B. SELECT, SHOW, DESCRIBE
oder EXPLAIN, gibt mysqli_query() ein
mysqli_result-Objekt zurück. Bei anderen
erfolgreichen Abfragen gibt mysqli_query() true zurück.
Beispiele
Beispiel #1 mysqli::query()-Beispiel
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Erstellen einer Tabelle gibt keine Ergebnismenge zurück */
$mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");
printf("Tabelle myCity erfolgreich erstellt.\n");
/* Select-Abfragen geben eine Ergebnismenge zurück */
$result = $mysqli->query("SELECT Name FROM City LIMIT 10");
printf("Select gab %d Zeilen zurück.\n", $result->num_rows);
/* Um große Datenmengen abzurufen, verwenden wir MYSQLI_USE_RESULT */
$result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT);
/* Hinweis: Solange nicht alle Datensätze vollständig abgerufen wurden oder
die Ergebnismenge geschlossen wurde, können keine Funktionen ausgeführt
werden, die mit dem Server interagieren. Alle Aufrufe werden einen
'out of sync'-Fehler zurückgeben */
$mysqli->query("SET @a:='this will not work'");
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Erstellen einer Tabelle gibt keine Ergebnismenge zurück */
mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");
printf("Tabelle myCity erfolgreich erstellt.\n");
/* Select-Abfragen geben eine Ergebnismenge zurück */
$result = mysqli_query($link, "SELECT Name FROM City LIMIT 10");
printf("Select gab %d Zeilen zurück.\n", mysqli_num_rows($result));
/* Um große Datenmengen abzurufen, verwenden wir MYSQLI_USE_RESULT */
$result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT);
/* Hinweis: Solange nicht alle Datensätze vollständig abgerufen wurden oder
die Ergebnismenge geschlossen wurde, können keine Funktionen ausgeführt
werden, die mit dem Server interagieren. Alle Aufrufe werden einen
'out of sync'-Fehler zurückgeben */
mysqli_query($link, "SET @a:='this will not work'");
Oben gezeigte Beispiele erzeugen
eine ähnliche Ausgabe wie:
Tabelle myCity erfolgreich erstellt.
Select gab 10 Zeilen zurück.
Fatal error: Uncaught mysqli_sql_exception: Commands out of sync; you can't run this command now in...