cRequest
Aus CavoxCms Wiki
Inhaltsverzeichnis |
Requestvariabeln
Requestvariabeln sind in der Form module:component:key=value aufgebaut und können per GET oder POST übermittelt werden. Ein einmal übermittelter Wert wird allerdings dauerhaft in der Session gespeichert, und ändert seinen Wert erst wieder, wenn er neu gesetzt wird. So können einzelne Komponenten oder Funktionen ihren Anzeigestatus beibehalten, auch wenn sich andere Komponenten anderer Module autonom verhalten und müssen Variablen nicht in Links weitergeben. Einige Requestvariablen, in der Form key=value, werden vom System verwendet (wie z.B. „page“), alle restlichen werden als Kommando-Parameter verwendet und werden nicht zwischengespeichert.
Request Variabeln (_POST hat höhere Priorität als _GET) werden in der Session gespeichert für Schlüssel die als module:component:key aufgebaut sind, das heisst, wenn sie einmal gesetzt wurden, werden sie beim nochmaligen Abrufen gleich ausgelesen.
Beispiel:
$gallery = cRequest::get("pid", "numeric", 0, "galleries");
Statische Funktions-Deklaration:
function cRequest::get($key, $type, $default=null, $component_name=null, $module_name=null)
Wird keine Komponente oder kein Modul angegeben, wird automatisch die aktuelle Komponente bzw. das aktuelle Modul angenommen.
Commandvariabeln
Commandvariabeln sind im Gegensatz zu Requestvariabeln flüchtig, werden also nicht gespeichert. Der Key kann direkt angegeben werden, also zum Beispiel name. Ein Formular (verarbeitet in einem Command; übergeben per cParameters) wird so übermittelt. Einige Keys sind allerdings reserviert und dürfen in Formularen nicht verwendet werden.
cRequest::getCommandParameters(); // returns cParameters
Reserviert
- un
- pw
- page
- cmd
- design
- lang
Filtervariabeln
Filtervariabeln sind Commandvariabeln, die mit einem Underscore ("_") beginnen. Einige Keys sind allerdings reserviert und dürfen nicht zum Filtern verwendet werden. Der Filter kann dazu verwendet werden, um einen View zu filtern. (TODO: Konzept noch nicht gut, verbessern.)
cRequest::getFilter(); // returns cParameters
Reserviert
- _output
- _form_hash
- _params (Ajax)
- _html (Ajax)
