Ausdrücke
Der Select-Query-Builder unterstützt die Verwendung von Ausdrücken in der Feldliste. Beispiele für Ausdrücke sind „verdoppeltes Altersfeld“, „Anzahl aller Namensfelder“ oder eine Teilzeichenkette eines Titel-Feldes. Beachten Sie, dass viele Ausdrücke SQL-Funktionen verwenden können, und nicht alle SQL-Funktionen für alle Datenbanken standardisiert sind. Modulentwickler sollten sicherstellen, dass nur Ausdrücke verwendet werden, die mit den unterstützten Datenbanken kompatibel sind. (Siehe Liste der Funktionen und Operatoren)
Um einen Ausdruck zur Abfrage hinzuzufügen, verwenden Sie die Methode addExpression().
$count_alias = $query->addExpression('COUNT(uid)', 'uid_count');
$count_alias = $query->addExpression('created - :offset', 'timestamp', array(':offset' => 3600));
Die erste Zeile fügt „COUNT(uid) AS uid_count“ zur Abfrage hinzu. Der zweite Parameter ist das Alias für das Feld. In seltenen Fällen, wenn das Alias bereits verwendet wird, wird ein neues generiert, und der Rückgabewert von addExpression() ist dann das verwendete Alias. Wenn kein Alias angegeben wird, wird ein Standardwert wie „expression“ (oder expression_2, expression_3 usw.) generiert.
Der optionale dritte Parameter ist ein assoziatives Array mit Platzhalterwerten, die als Teil des Ausdrucks verwendet werden.
Beachten Sie, dass manche SQL-Ausdrücke nicht funktionieren, wenn sie nicht von einer GROUP BY-Klausel begleitet werden, die mit $query->groupBy() hinzugefügt wurde. Der Entwickler muss sicherstellen, dass die generierte Abfrage tatsächlich gültig ist.