Quelltext der Seite Datenbank Klasse verwenden

{{stub}}


= Informationen zur Datenbank-Klasse =

Contao bietet für Entwickler eine Klasse an, um mit der Datenbank zu kommunizieren. Diese sollte beim Entwickeln von Erweiterungen unbedingt verwendet werden!

* [http://api.contao.org/Library/_libraries---Database.php.html Dokumentation der Klasse]

Die Datenbank-Klasse bietet mehrere Vorteile:
* Die Daten werden "gesäubert" und störende Zeichen maskiert
* Ein Objekt der Klasse Database_Result wird zurückgegeben. Dieses enthält alle Informationen zum Query
* Ersparnis von Schreibarbeit

= Operationen auf der Datenbank =

Die Beispiele setzen voraus, dass zuvor das Datenbank-Modul geladen wurde:

<source lang="php">
$this->import('Database');
</source>

== Datensätze lesen ==

'''Lesen von Datensätzen ohne Bedingung'''

<source lang="php">
$result = $this->Database->prepare("SELECT * FROM tl_log")->execute();
</source>

'''Ausgeben der Datensätze'''

<source lang="php">
echo $result->numRows; // Anzahl der gefundenen Datensätze ausgeben
echo $result->id; // ID des 1. Datensatzes ausgeben
// Und alle anderen ID's ausgeben
while($result->next())
{
  echo $result->id;
}
</source>

'''Lesen von Datensätzen mit Bedingung'''

<source lang="php">
$result = $this->Database->prepare("SELECT * FROM tl_log WHERE id=?")->execute(1);
$result = $this->Database->prepare("SELECT * FROM tl_log WHERE id=? OR id=?")->execute(1, 5);
</source>

Die Fragezeichen sind Wildcards. Sie werden der Reihenfolge nach von den Parametern der execute-Funktion ersetzt. Dabei werden die parameter escaped, also für die Datenbank aufbereitet.
Das schützt allerdings '''nicht''' vor boshaften Benutzereingaben. Diese sollten immer mit der Input-Klasse verarbeitet werden!

'''Lesen von Datensätzen mit Limit'''

<source lang="php">
$result = $this->Database->prepare("SELECT * FROM tl_log")->limit(30)->execute();
$result = $this->Database->prepare("SELECT * FROM tl_log")->limit(30, 40)->execute();
</source>

Das erste Beispiel liest die (ersten) 30 Datensätze, die mit der Suchbedingung (hier alle Datensätze) übereinstimmen. Das zweite Beispiel liest die 30 Datensätze ab Datensatz Nr. 40.

== Datensätze schreiben ==

Datensätze können auch über die Datenbank-Klasse geschrieben werden. Es gibt dafür zwei Möglichkeiten.

'''Einzelne Werte per Wildcard setzten'''

<source lng="php">
$this->Database->prepare("UPDATE tl_log SET source = ? WHERE id=?")->execute('BE', 12345);
</source>

'''Mehrere Werte per set-Methode setzten'''
<source lng="php">
$set = array('tstamp' => time(), 'source' => 'BE', 'action' => 'GENERAL');
$this->Database->prepare("UPDATE tl_log %s WHERE id=?")->set($set)->execute(12345);
</source>

Diese Methode funktioniert natürlich auch mit einem INSERT-Statement. Hier das Beispiel, wo Sie anschließend auch gleich die ID des neuen Datensatzes bekommen:

<source lng="php">
$set = array('tstamp' => time(), 'source' => 'BE', 'action' => 'GENERAL');
$objInsert = $this->Database->prepare("INSERT INTO tl_log %s")->set($set)->execute();
echo $objInsert->insertId;
</source>

== Das Ergebnis auswerten ==

= Tipps & Tricks =
* [[SQL Like Abfrage in doppelten Prozentzeichen]]


[[Category:Dev HOWTOS]]