Variablen - baseportal Dokumentation

Variablen sind "Platzhalter" für Werte und werden wie in vielen Programmiersprachen eingesetzt. Einfache Variablen beginnen mit dem $-Zeichen und müssen mit einem Buchstaben beginnen, gefolgt von weiteren Buchstaben, Zahlen oder Unterstrichen (Beispiele: $Text, $Mein_Name, $urx_123). Inhalte von Variablen können beliebig lang sein und aus Zahlen, Texten oder beliebigen anderen Zeichen bestehen.

Die über eine URL oder in einem baseportal-Tag angegebenen Parameter werden automatisch als Variablen zur Verfügung gestellt.

Variablen über die URL weitergeben

<perl>
out "Zähler: ",$cnt++,"<p>";
out '<a href="/cgi-bin/baseportal.pl?htx=/zaehler&cnt=',$cnt,'">Weiter';
</perl>

Dieses Code-Stück fungiert als Zähler. Jeder Klick auf "Weiter" erhöht die Zahl um 1. Dies geschieht durch die Variable $cnt, deren Wert durch den Parameter in der URL weitergegeben wird und im Template zur Verfügung steht.

Variablen über Tag-Parameter weitergeben

Pfiffig ist der Einsatz von Variablen, um HTML-Bausteine individuell anzupassen:

<div style="text-align:center;font-weight:bold">$Text</div>

Die Variable $Text wird nun mit dem aktuellen Wert ersetzt. Angenommen obige Zeile wird im Template titel gespeichert, so führt der Einbau in eine andere Seite durch...

<include src=titel Text=Einleitung>

...zu folgender Ausgabe:

Einleitung

Eine Reihe von Werten werden von baseportal in Spezialvariablen bereitgehalten. Sie beginnen (fast) immer mit einem Unterstrich _. Obwohl es möglich ist, sollten Sie also auf eigene Variablen, die mit einem Unterstrich beginnen, verzichten.

Datenbank-Abruf:

Variable	Bedeutung
$_db	Name der zuletzt genutzten Datenbank
$_id	ID des Datensatzes
$htx	aufgerufene Seite (über die URL, "..baseportal.pl?htx=$htx")
$_loop	fortlaufende Nummer der geholten Datensätze
$_range	Ausgabebereich Start
$_range_length	Ausgabebereich Anzahl
$_amount	Anzahl Datensätze die beim letzten Abruf tatsächlich geholt wurden.
$_amount_query	Anzahl Datensätze die beim letzten Abruf ohne "range" geholt worden wären.
$_amount_all	Anzahl Datensätze die in der zuletzt genutzten Datenbank insgesamt enthalten sind

Parameter und Abfragewerte:

Variable	Bedeutung
%_cgi	Werte die über CGI (GET oder POST) mit "=" übergeben wurden(z.B. Farbe=Rot)
%_get	Werte die über CGI, in Tags oder über eine Datenbank-Abfrage gesetzt wurden (z.B. Farbe=Rot)
%_sel	Abfragewerte (z.B. Name==a)
%_put	Zu schreibende Werte (z.B. Name:=Hans)
%_put_last	Tatsächlich geschriebene Werte
$_put_id	ID des zuletzt geschriebenen Datensatzes
%_raw	Ungefilterte Ausgabe von Feldern (z.B. bei Datum, Link oder Email) - man erhält den tatsächlichen Inhalt des Feldes
%_loop	Enthält den aktuellen Datensatz bei `<loop>` oder `get; get_next();`
%_	Enthält die Werte der Parameter eines per XML selbst-definierten Tags

Durch %_cgi und %_get können auch Parameter abgefragt werden, die nicht über Variablen zugänglich sind, weil sie für Variablennamen unzulässige Zeichen enthalten (z.B: Leerzeichen, Sonderzeichen usw.) oder weil Sie durch eigene Variablen überschrieben wurden. Beispiele: $_get{"Mein Name"}; $_cgi{"12345"};

Rechteverwaltung

Variable	Bedeutung
$uid	Name des Nutzers (über die URL)
$upw	Passwort des Nutzers (über die URL, wird bei der Anmeldung übermittelt)
$sid	Session-Id des Nutzers (über die URL)
$_user	Name des angemeldeten Nutzers. Definiert leer, wenn Anmeldung fehlgeschlagen
%_user	Feldinhalte der Nutzer-Datenbank des angemeldeten Nutzers
$_session	Session-Id des Nutzers
%_session	Hash zum Weiterreichen von (internen) Session-Variablen

Umgebungsvariablen

Variable	Beschreibung
$_REMOTE_ADDR	IP des Nutzers
$_REMOTE_PORT	Port über den die Seite aufgerufen wurde
$_HTTP_USER_AGENT	Browser der zum Abruf genutzt wurde
$_HTTP_REFERER	URL der Seite, die davor aufgerufen wurde