eZHTTPTool: Requests, Sitzungen und Weiterleitungen #

Teil 8, Referenz 10. Mit eZHTTPTool (lib/ezutils/classes/ezhttptool.php) lesen Kernel-Code und Erweiterungen den Request und die Sitzung. Verwenden Sie es statt $_POST, $_GET und $_SESSION: Es kümmert sich um den Start der Sitzung, protokolliert fehlende Variablen und hält Ihren Code testbar.

<?php
$http = eZHTTPTool::instance();

Request-Variablen #

Fehlt die Variable und ist der Ersatzwert null, schreiben diese Methoden „Undefined post variable“ in die Debug-Ausgabe. Übergeben Sie für optionale Variablen einen Ersatzwert:

<?php
$http = eZHTTPTool::instance();
$name = trim( (string)$http->postVariable( 'Name', '' ) );
$page = max( 1, (int)$http->getVariable( 'page', 1 ) );
$ids = array_map( 'intval', (array)$http->postVariable( 'SelectedIDArray', array() ) );
if ( $http->hasPostVariable( 'StoreButton' ) )
{
    // the form's Store button was pressed
}

Jeder Wert aus dem Request ist nicht vertrauenswürdig: Wandeln Sie Zahlen um, prüfen Sie Zeichenketten und maskieren Sie bei der Ausgabe (Sicherheit in Erweiterungen). In Modul-Views prüft der Kernel bei POST außerdem das Formular-Token (ezformtoken und CSRF).

Sitzung #

Versehen Sie die Namen mit dem Namen Ihrer Erweiterung als Präfix (MyExtLastFilter). Halten Sie Sitzungen klein: Sie werden bei jedem Request dieses Benutzers gelesen.

Weiterleitungen #

Leiten Sie in einer Modul-View über das Modul weiter; der Kernel führt die Weiterleitung dann zum richtigen Zeitpunkt aus:

return $Module->redirectTo( '/myext/list' );

eZModule hat außerdem redirectToView( $viewName, $parameters ) und redirect( $moduleName, $viewName, $parameters ) (eZModule und Modulergebnisse).

Außerhalb eines Moduls (in einem Skript, einem Handler) sendet eZHTTPTool::redirect( $path, $parameters = array(), $status = false, ... ) die Weiterleitung sofort. Leiten Sie nie auf eine Adresse aus dem Request weiter, ohne zu prüfen, dass sie auf Ihrer eigenen Website liegt; der Kernel beschränkt die Hosts für Weiterleitungen (eZModule::allowedRedirectHosts()).

Andere Websites abrufen #

eZHTTPTool::getDataByURL( $url, $justCheckURL = false, $userAgent = false, $forceGetRequest = false ) ruft eine URL ab. Für alles, was über ein einfaches GET hinausgeht, verwenden Sie cURL direkt, mit Timeouts.

Verwandte Seiten #

• Zurück: eZUser und Zugriffsprüfungen
• Weiter: eZSys und eZExtension
• View-Parameter
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.