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

    Abschnitt 1

    < Allgemeines Inhaltsverzeichnis Abschnitt 2 Struktur der Platzhalter >

    1.1. Funktionsprinzip

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

    1. Suche und Einlesen der Konfigurationsdatei (Standard: atp.conf.php im gleichen Verzeichnis)
    2. Einbinden der init.php der Anwendung
    3. Aufruf der Funktion init() der Anwendung
    4. 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