Requests

Die Request Funktionen werden in REDAXO verwendet, um mit den superglobalen Variablen $_GET, $_POST, $_REQUEST, $_SERVER, $_COOKIE, $_ENV, $_SESSION und $_FILES zu arbeiten. Die REDAXO Funktionen sollten bevorzugt verwendet werden, um die superglobalen Variablen abzufragen bzw. anzusprechen.

Parameter der Funktionen rex_get, rex_post, rex_request, rex_files, rex_env, rex_cookie

Die Funktionen rex_get, rex_post, rex_request, rex_files, rex_env und rex_cookie können mit folgenden Parametern aufgerufen werden (Beispiel für rex_get):

rex_get('var_name','var_type','default')

Für var_type sind folgende Werte gültig:

• string
• int
• integer
• bool
• boolean
• double
• float
• real-
• object
• array

Das Ergebnis wird dann in den entsprechenden Typ umgewandelt.

Hinweis: Die Daten sollten in der weiteren Verarbeitung „gesäubert“ werden. Zum Beispiel sollten mit rex_get(), rex_post() und rex_request() übernommene Strings vor der Ausgabe auf der Website mit rex_escape($string) bearbeitet werden, um mögliches HTML umzuwandeln. Damit wird Cross-Site-Scripting (XSS) verhindert.

Erlaubte Werte explizit angeben

Seit REDAXO 5.17 ist es möglich, bei rex_get(), rex_post() und rex_request() explizit die erlaubten Werte als Array anzugeben. Dies bietet eine zusätzliche Sicherheitsebene:

// Nur bestimmte String-Werte erlauben
$sort = rex_get('sort', ['name', 'date', 'title']); 
// Wenn 'sort' nicht gesetzt ist oder einen anderen Wert hat, wird 'name' zurückgegeben

// Mit eigenem Default-Wert
$status = rex_get('status', ['active', 'inactive', 'pending'], 'active');

// Auch mit Integer-Werten möglich
$limit = rex_get('limit', [10, 20, 50, 100]);

// Mit null als Default
$filter = rex_get('filter', ['new', 'popular', 'featured'], null);

Funktionsweise:

• Der Wert muss exakt einem der Werte im Array entsprechen
• Ist der Parameter nicht gesetzt oder ungültig, wird der erste Wert aus dem Array verwendet
• Optional kann ein anderer Default-Wert als dritter Parameter angegeben werden
• Der Default-Wert muss nicht im Array der erlaubten Werte enthalten sein

Anwendungsbeispiele:

// Sortierung in einer Produktliste
$sort = rex_get('sort', ['price_asc', 'price_desc', 'name', 'date'], 'name');

// Pagination
$page = rex_get('page', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10], 1);

// Filter-Status
$status = rex_post('status', ['published', 'draft', 'archived']);

// Anzeigemodus
$view = rex_get('view', ['grid', 'list'], 'grid');

Sessions

Wird im Frontend eine Session benötigt, so muss diese explizit gestartet werden. Hierzu genügt in der Datei boot.php eines AddOns folgender Code:

if (rex::isFrontend()) {
    rex_login::startSession();
}

alternativ

if (!rex::isBackend()) {
    rex_login::startSession();
}

Beispiel: Code nur ein einziges Mal ausführen, wenn die Website aufgerufen wird.

<?php
//Beim ersten Aufruf der Website wird die Session gestartet. Sie bleibt so lange aktiv, bis der Browser beendet wird.
rex_login::startSession();
if (rex_session('MeineVariable')) {
    //Code der ausgeführt ist, wenn die Variable gesetzt ist (direkt NACH dem ersten Aufruf der Website bis zum beenden des Browsers
} else {
    //Code der beim ersten Aufruf der Website ausgeführt wird bis die Variable 'MeineVariable' gesetzt ist
}
//Variable wird gesetzt
rex_set_session('MeineVariable', 'MeinWert');