sqlite_query
SQLiteDatabase::query
(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)
sqlite_query -- SQLiteDatabase::query — Führt auf einer Datenbank eine Abfrage durch und liefert das Abfrageergebnis zurück
Beschreibung
$dbhandle
, string $query
[, int $result_type
= SQLITE_BOTH
[, string &$error_msg
]] ) : resource$query
, resource $dbhandle
[, int $result_type
= SQLITE_BOTH
[, string &$error_msg
]] ) : resourceObjektorientierter Stil (Methode):
$query
[, int $result_type
= SQLITE_BOTH
[, string &$error_msg
]] ) : SQLiteResult
Führt eine, durch den Parameter query
übergebene,
SQL-Anfrage auf der übergebenen Datenbank-Verbindung aus.
Parameter-Liste
-
dbhandle
-
Die SQLite-Datenbankressource, zurückgegeben von sqlite_open(), wenn prozedural genutzt. In der objektorientierten Notation wird dieser Parameter nicht benötigt.
-
query
-
Die auszuführende Anfrage.
Daten innerhalb einer Anfrage sollten maskiert werden.
-
result_type
-
Der optionale Parameter
Ergebnis_Typ
akzeptiert eine Konstante und bestimmt, wie das zurückgegebene Array indiziert wird. Während mitSQLITE_ASSOC
nur assoziative Indizes (Namensfelder) zurückgegeben werden, werden mitSQLITE_NUM
nur numerische Indizes (geordnete Feldnummern) zurückgegeben.SQLITE_BOTH
gibt sowohl assoziative als auch numerische Indizes zurück.SQLITE_BOTH
ist die Standardeinstellung. -
error_msg
-
Die spezifizierte Variable wird im Falle eines Fehlers gesetzt. Diese ist besonders wichtig, denn SQL-Syntaxfehler können nicht mittels sqlite_last_error() ausgelesen werden.
Hinweis: Zwei alternative Syntaxen werden für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter
dbhandle
der erste Parameter der Funktion ist.
Rückgabewerte
Diese Funktion gibt ein Ergebnis-Handle zurück. Im Fehlerfall wird FALSE
zurückgegeben.
Für Anfragen, die Reihen liefern, kann das Abfrageergebnis mit Funktionen, wie
sqlite_seek() oder sqlite_fetch_array()
augelesen werden.
Ungeachtet des Anfrage-Typs, gibt diese Funktion FALSE
zurück, wenn
die Anfrage fehlschlägt.
sqlite_query() gib ein gepuffertes Ergebnis, dessen Zeilen einzeln ansprechbar sind. Dies ist für kleine Abfragen nützlich, bei denen man abwechselnd unterschiedliche Zeilen abfragen will. Die gepufferten Ergebnisse belegen Speicher, um das gesamte Ergebnis halten zu können. Dieser Speicher wird erst dann wieder freigegeben, wenn das komplette Ergebnis durchlaufen wurde. Wenn nur ein sequentieller Zugriff auf die Daten nötig ist, wird empfohlen, die performantere Funktion sqlite_unbuffered_query() zu nutzen.
Anmerkungen
SQlite ist in der Lage durch Semikolon getrennte Anfragen in einem Schub auszuführen. Diese können aus einer Datei geladen oder durch ein Skript bereitgestellt werden. Wie auch immer, das funktioniert nur, wenn das Ergebins der Anfrage nicht benutzt wird. Sollte es doch genutzt werden, wird nur die erste SQL-Anfrage der Liste ausgeführt. Die Funktion sqlite_exec() wird immer Mehrfach-Anfragen ausführen.
Wenn Mehrfach-Anfrage ausgeführt werden, wird die Funktion im Fehlerfall
FALSE
zurückgeben, anderenfalls jedoch ein undefiniertes Ergebnis
(das kann, sollte die Anfrage gelingen, TRUE
oder ein Ergebnis-Handle sein).
Siehe auch
- sqlite_unbuffered_query() - Führt eine Abfrage aus, aber übernimmt die Daten nicht gleich ins PHP
- sqlite_array_query() - Führt eine Datenbankabfrage durch und liefert das gesamte Abfrageergebnis als Liste zurück
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-sqlite-query.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.