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:

Name	Beschreibung
`$_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:

Name	Beschreibung
`%_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();`
`%_cookies`	Die vom Browser übermittelten "Cookies"

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

Name	Beschreibung
`$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

Ausgabe und Fehlerbehandlung

Name	Beschreibung
$_out	Enthält den bisher ausgegebenen Text.
$_outx	Enthält die bisher ausgegebenen Statusmeldungen.
$_error	Fehlername des letzten Fehlers
%_error	enthält (sofern vorhanden) alle verfügbaren Informationen über den letzten Fehler: `name` => nochmals den Fehlernamen des letzten Fehlers `text` => Ausführliche Fehlerbeschreibung des letzten Fehlers in der ausgewählten Sprache `line` => Zeilennummer des Scripts, bei der der Fehler aufgetreten ist `htx` => Name des Templates, in dem der Fehler aufgetreten ist `from` => Funktion in der der Fehler aufgetreten ist
$_error_mode	ungesetzt/leer = Fehler an der Stelle des Auftretens ausgeben `top` = gesammelt zu Beginn `bottom` = gesammelt am Ende `no` = keine Fehler ausgeben
@_error	Array von `%_error`-Hashes: Alle gesammelten (noch nicht ausgegebenen) Fehler also `$_error[0]{name}` wäre der Name des ersten noch nicht ausgegebenen Fehlers
$_error_handler	Übergebene Routine wird im Fehlerfall ausgeführt

XML / Tag-Datenbanken

Name	Beschreibung
`$_`	Enthält im "Ende"-Code den Inhalt des eingeschlossenen Bereichs
`%_`	Die Parameter des Tags aufgeschlüsselt nach Name=Wert
`$_tag`	Name des Tags (Nur bei Name=* sinnvoll)
`@_parents`	Die umschliessenden Tags
`$_query`	Die Parameter des Tags als kompletter Text
`$_begintag`	Wenn gesetzt, befindet sich der Code beim Anfangstag
`$_empty`	Wenn gesetzt, wurde das Tag als markiert (`<tag />`)

Umgebungsvariablen

Name	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

Volltextsuche

Name Beschreibung
`$_fullsearch` Suchbegriffe
`$_fullsearch_range` Starteintrag für die Volltextsuche
`$_fullsearch_range_length` Anzahl der zu durchsuchenden Einträge
`$_fullsearch_match` Anzahl der zu findenden Treffer
`$_fullsearch_match_pos` Eine Position nach dem zuletzt gefundenen Treffer
`$_fullsearch_amount` Anzahl der bei der Volltextsuche gefundenen Treffer
`$_fullsearch_regex` Muster um im Text die Suchtexte zu markieren