Anandos Template-Parser - technische Dokumentation - 1 - Arbeitsweise des Parsers

Abschnitt 1

1.1. Funktionsprinzip

Im Normalfall heißt der Parser "index.php", der folgende Aktionen ausführt:

Suche und Einlesen der Konfigurationsdatei (Standard: atp.conf.php im gleichen Verzeichnis)
Einbinden der init.php der Anwendung
Aufruf der Funktion init() der Anwendung
Generierung des endgültigen HTML-Quelltextes aus dem Template unter Abarbeitung der enthaltenen Marker und Platzhalter (Pattern)

Als Datenquellen für die variablen Inhalte in den Templates werden vom Parser als auch von den Anwendungsfunktionen bereitgestellt:

Einfache Variablen
Arrays
Funktionen
Lokalisierungsdateien zur Sprachübersetzung

1.2. Konfiguration

In einer Konfigurationsdatei 'atp.conf.php' werden die Parser-Grundeinstellungen festgelegt: Siehe dazu Anhang A.

Die Anwendungsfunktionen werden als PHP-Dateien bereitgestellt. Mindestens eine Datei "init.php" mit einer Funktion namens "Init()" muss vorhanden sein.
Die Init()-Funktion wird vom Parser zuerst, noch vor dem Session-Start aufgerufen.

1.3. API

Damit auch Folgeaufrufe einer Anwendung, die über einen Parser-Parameter gewählt oder modifiziert wurde, funktionieren, muss die Anwendung sicherstellen, dass für jeden Parseraufruf diese Parameter erneut mitgegeben werden.
Das läßt sich z.B. realisieren, indem über Text-Pattern (s.u.) belegte hidden-Felder verwendet werden, deren Inhalt dann bei jedem submit automatisch mitgesendet wird.

Folgende, per GET/POST übergebene Parameter werden vom Parser ausgewertet:

Variable	Werte	Beschreibung
ATP_InstanceClose	beliebig	Der schließt die aktuelle Instanz und beendet sich sofort, so dass keine Daten mehr an den Clienten gesendet werden. Diese Funktion ist für die Verwendung in einer onunload-Funktion vorgesehen.
nATP_Inst	Nummer der Instanz	Schaltet auf die angegebene Instanz um. Ist der Parameter nicht vorhanden, ist die Instanz 0 aktiv

Artikel zuletzt bearbeitet am: 13.04.2019 15:34