Die folgenden tabellarischen Auflistungen der wichtigsten MySQLi-Methoden (Funktionen) und Eigenschaften sollen es Ihnen erleichtern, sich mit MySQLi vertraut zu machen. Sämtliche Methoden werden, wie Sie bereits erfahren haben, auf einem Verbindungsobjekt der MySQLi-Klasse oder auf einem Resultatobjekt ausgeführt, z. B.:
$db = new mysqli('localhost', 'root', 'passwort', 'testbank');
$db->query('SELECT * FROM stadt ORDER by id');
Die prozedurale Alternative steht Ihnen selbstverständlich ebenfalls für jede MySQLi-Methode zur Verfügung, z. B.:
$db = mysqli_connect("localhost", "root", "passwort", "test");
mysqli_query($db,'SELECT * FROM stadt ORDER by id');
MySQLi-Objekt
Die folgende Tabelle fasst Eigenschaften des MySQLi-Objekts zusammen (z. B. $db).
| Eigenschaft | Bedeutung | | affected_rows | Liefert die Anzahl von Datensätzen, die durch das letzte UPDATE geändert, durch das letzte DELETE gelöscht oder durch das letzte INSERT eingefügt wurden. Kann direkt nach mysqli_query() aufgerufen werden, bei UPDATE-, DELETE- oder INSERT-Anweisungen. Bei SELECT-Anweisungen funktioniert affected_rows() wie num_rows(). | | errno | Liefert den Fehlercode für die zuletzt aufgerufene Funktion in Form einer Zahl (Integer). | | error | Liefert eine Fehlermeldung für die zuletzt aufgerufene Funktion in Form eine Zeichenkette (String). | | field_count | Liefert die Anzahl von Spalten der letzten Anfrage auf der Verbindung. | | host_info | Liefert eine Zeichenkette zurück, die den Typ der benutzten Verbindung beschreibt, inklusive des Server-Hostnamens, z. B. »localhost via TCP/IP«. | | info | Liefert Informationen über die zuletzt ausgeführte Anfrage. | | insert_id | Liefert die Kennung, die für eine AUTO_INCREMENT-Spalte durch die vorherige Anfrage erzeugt wurde. Benutzen Sie diese Funktion, nachdem Sie eine INSERT-Anfrage für eine Tabelle durchgeführt haben, die ein AUTO_INCREMENT-Feld enthält. | | protocol_version | Liefert die Protokollversion zurück, die von der aktuellen Verbindung genutzt wird (Standardwert: Protocol version: 10). | | sqlstate | Liefert den SQL-Status und Fehlercodes einer vorher gesendeten Abfrage. | | thread_id | Liefert die Thread-ID der aktuellen Verbindung. Der Wert kann als Argument für mysqli_kill() benutzt werden, um den Thread zu entfernen. | | thread_safe | Ermittelt den aktuellen Status der Thread-Sicherheit. | | warning_count | Liefert die Anzahl der Warnungen, die die letzte Abfrage erzeugt hat. |
Die folgende Tabelle enthält Methoden des MySQLI-Objekts (z. B. $db).
| Methode | Bedeutung | | autocommit | Aktiviert bzw. deaktiviert die automatische Bestätigung von Transaktionen. | | change_user | Wechselt den Benutzer für die aktuelle Verbindung. | | character_set_name | Liefert den aktuellen Zeichensatz für die Verbindung. | | close | Schließt die geöffnete Verbindung. | | commit | Bestätigt die aktuelle Transaktion. | | connect | Öffnet eine Verbindung zu einem MySQL-Datenbankserver. | | get_client_info | Liefert Informationen über den MySQL-Client. | | get_client_version | Liefert Informationen über die verwendete MySQL-Version. | | get_host_info | Liefert eine Zeichenkette zurück, die den Typ der benutzten Verbindung beschreibt, inklusive des Server-Hostnamens, z. B. »localhost via TCP/IP«. | | init | Initialisiert ein MySQLi-Objekt, welches von mysqli_real_connect verwendet werden kann. | | info | Liefert Informationen über die zuletzt ausgeführte Anfrage. | | kill | Versucht, den von MySQL belegten Thread zu entfernen. Dabei wird eine Thread-ID (pid) verwendet. Um die Thread-ID der aktuellen Verbindung zu ermitteln, kann mysqli_thread_id genutzt werden. | | multi_query | Sendet eine oder mehrere Abfragen an die Datenbank. Die Abfragen werden durch ein Semikolon voneinander getrennt. | | more_results | Überprüft, ob weitere Abfrageergebnisse von Mehrfachabfragen vorhanden sind. | | next_result | Nächstes Abfrageergebnis einer Mehrfachabfrage abrufen. | | options | Setzt diverse Verbindungsoptionen. | | ping | Sendet einen Ping zur Kontrolle der Verbindung an den Datenbankserver. | | prepare | Ermöglicht die Vorbereitung einer Abfrage. Vorbereitete Abfragen sind bei wiederholter Ausführung deutlich schneller. | | query | Sendet eine Abfrage direkt an den Datenbankserver. | | real_connect | Öffnet eine Verbindung zu einem MySQL-Datenbankserver. | | real_query | Führt eine Abfrage aus. | | rollback | Ermöglicht die Rückabwicklung einer Transaktion. | | select_db | Legt eine andere Datenbank als Standardauswahl fest. Dies entspricht dem SQL-Befehl USE. | | send_query | Sendet eine Abfrage an die Datenbank. | | sqlstate | Liefert den SQL-Status und Fehlercodes einer vorher gesendeten Abfrage. | | ssl_set | Legt eine gesicherte SSL-Verbindung fest. | | stat | Liefert den aktuellen Status des Systems. | | stmt_init | Initialisiert eine Abfrage und gibt ein Objekt zurück, mit dessen Hilfe die Abfrage gesteuert werden kann. | | thread_safe | Ermittelt den aktuellen Status der Thread-Sicherheit. | | use_result | Bereitet ein Abfrageergebnis zur Verwendung vor. |
Anweisungsobjekt
Die folgende Tabelle fasst Eigenschaften des Anweisungsobjekts zusammen (z. B. $befehl).
| Eigenschaft | Bedeutung | | affected_rows | Liefert die Anzahl von Datensätzen, die durch das letzte UPDATE geändert, durch das letzte DELETE gelöscht oder durch das letzte INSERT eingefügt wurden. Kann direkt nach mysqli_query() aufgerufen werden, bei UPDATE-, DELETE- oder INSERT-Anweisungen. Bei SELECT-Anweisungen funktioniert affected_rows() wie num_rows(). | | errno | Liefert den Fehlercode für die zuletzt aufgerufene Funktion. | | error | Liefert eine Fehlermeldung für die zuletzt aufgerufene Funktion. | | param_count | Liefert die Anzahl der Parameter für die aktuelle Abfrage. | | sqlstate | Liefert den SQL-Status und Fehlercodes einer vorher gesendeten Abfrage. | | ssl_set | Legt eine gesicherte SSL-Verbindung fest. |
Die folgende Tabelle enthält die Methoden des Anweisungsobjekts (z. B. $befehl).
| Methode | Bedeutung | | bind_param | Erzeugt Parameter für eine vorbereitete Abfrage. | | bind_result | Erzeugt ein Abfrageergebnis-Objekt. | | close | Schließt die geöffnete Verbindung. | | data_seek | Setzt den Abfrageergebnis-Zeiger auf einen festgelegten Datensatz. | | execute | Führt eine vorbereitete Abfrage aus. | | fetch | Liefert das vorbereitete Abfrageergebnis mit verschiedenen Optionen. | | get_metadata | Liefert globale Informationen zu einer vorbereiteten Abfrage. | | prepare | Ermöglicht die Vorbereitung einer Abfrage. Vorbereitete Abfragen sind bei wiederholter Ausführung deutlich schneller. | | send_long_data | Versendet große Datenpakete. | | store_result | Übermittelt die Abfrageergebnisse der zuletzt ausgeführten Abfrage. |
Ergebnis-Objekt
Die folgende Tabelle enthält Eigenschaften des Ergebnis-Objekts (z. B. $resultat).
| Eigenschaft | Bedeutung | | current_field | Liefert das aktuelle Feld des Abfrageergebnisses. | | field_count | Liefert die Anzahl der Felder. | | length | Liefert die Länge (Breite) eines Felds. | | num_rows | Liefert die Anzahl der Reihen im Abfrageergebnis. |
Die folgende Tabelle fasst die Methoden des Ergebnis-Objekts zusammen (z. B. $resultat).
| Methode | Bedeutung | | close | Schließt die geöffnete Verbindung. | | data_seek | Setzt den Abfrageergebnis-Zeiger auf einen festgelegten Datensatz. | | fetch_field_direct | Liefert direkt ein festgelegtes Feld. | | fetch_field | Liefert das nächste Feld einer Liste. | | fetch_fields | Liefert Felder als Array. | | fetch_lengths | Ermittelt die Breite des aktuellen Felds. | | fetch_object | Liefert einen Datensatz als Objekt. Felder sind nun Eigenschaften. | | fetch_row | Liefert einen Datensatz als numerisches bzw. einfaches Array. | | fetch_assoc | Liefert einen Datensatz als assoziatives Array. Die Schlüssel sind die Spaltennamen. | | field_seek | Setzt den Abfrageergebnis-Zeiger auf ein festgelegtes Feld. |
|
SELFPHP
SELFPHP - Damir Enseleit, info@selfphp.de, Impressum, Kontakt