| Pos | Attribut | Typ | Erforderlich | Beschreibung |
|---|---|---|---|---|
| 1 | file | string | Ja | Relativer Pfad zum Skript. |
| 2 | once | boolean | Nein | Das Skript wird nur einmal eingebunden (Standard: true). |
Mit der Smarty Funktion {require} können Sie in einem Smarty Template oder Block ein PHP Skript einbinden. Der relative Pfad zum PHP Skript folgt der üblichen Hierarchie im site Verzeichnis.
- site/<Mandant>/<Seitentyp>/
- site/<Mandant>/
- site/_global/<Seitentyp>/
- site/_global/
Wenn Sie Ihr Skript einbinden, werden folgende Variablen zur einfachen Verwendung bereitgestellt:
$smarty, $auth, $site, $page
Wenn Sie Ihr Skript in Blöcken einsetzen, sind zudem folgende Variablen vorhanden:
$_layout, $_orient, $_block, $_index
Jedes Skript wird nur einmalig beim Laden einer kompletten Seite eingebunden. Wenn Sie ein Skript öfters einbinden möchten, setzen Sie den Parameter once auf false.
{require file="path/script.php"}
{require file="path/script.php" once=false}
Verwenden Sie in Ihrem PHP Skript echo oder print um an der Stelle, an der Sie {require} aufrufen, eine Ausgabe zu machen.
Wenn Sie Blöcke verwenden, wird empfohlen Ihren PHP Code über require direkt im Template des Blocks einzubinden. Alternativ können Sie auch auf Page Magic Methoden, Page Extensions oder eigene Smarty Plugins zurückgreifen. Grundsätzlich sollte das Prinzip eingehalten werden, dass PHP Code, der zu einem Block gehört, auch im Block selbst gesetzt ist. Die klassische Vorgehensweise, PHP Code (mehr oder weniger global) in index.php Skripten zu platzieren, ist als veraltet anzusehen.