vtDbTable
(Master ab 3.0.4)
Gibt den Namen einer Virthos-Datenbanktabelle für die Verwendung in einer SQL-Abfrage aus.
Verwendung
{{vtDbTable: %Tabelle}}
- %Tabelle
Name der Datenbanktabelle (ohne Präfix)
Hinweise
Wenn man eigene Datenbankabfragen (z. B. mit vtDbQuery
) schreibt und dabei
auf Tabellen der aktuellen Virthos-Umgebung zugreift, erleichtert der
vtDbTable
-Platzhalter das Einbinden der Tabellennamen, da er automatisch das
aktuelle Tabellenpräfix ergänzt und den Namen in Backticks einschließt:
{{vtDbTable:content}}
ist gleichbedeutend mit
`{{vtConfig:mysqlTablePrefix}}content`
Würde man das Tabellenpräfix fest codieren und in der Abfrage z. B. direkt
vt2_content
schreiben, könnte dies bei einem späteren Serverumzug oder
beim Testen in einer Entwicklungsumgebung dazu führen, dass die Abfrage nicht
funktioniert, weil Virthos mit einem anderen Präfix konfiguriert ist.
Seit Virthos 3.6 kann derselbe Effekt erzielt werden, indem man Tabellennamen in Backticks einschließt und statt des Präfixes ein Prozentzeichen voranstellt.
Beispiel
<!--{{vtDbQuery: SELECT * FROM {vtDbTable:content} WHERE `id` = 123 }}-->
Dies ist gleichbedeutend mit folgender Schreibweise:
<!--{{vtDbQuery: SELECT * FROM `%content` WHERE `id` = 123 }}-->