HOWTO · PHP

Zurück zur vorherigen Seite in PHP

Dieses Tutorial stellt vor, wie man in PHP zur vorherigen Seite zurückkehrt

Auf dieser Seite

Um Besucher nach dem Absenden eines Formulars zur Formularseite zurückzuleiten, lesen Sie den optionalen Wert HTTP_REFERER aus $_SERVER, lassen Sie nur ein erlaubtes lokales Ziel zu und senden Sie mit header() einen Location-Header, bevor Sie eine Antwort ausgeben. Ein Referrer ist nicht garantiert vorhanden. Verwenden Sie daher ein sicheres lokales Ersatzziel.

Mit dem Request-Header HTTP_REFERER in PHP zur vorherigen Seite zurückkehren

Ein Formular auf index.php kann seine Daten an einen Handler wie home.php senden. Der Browser kann die URL der Formularseite im Request-Header HTTP_REFERER übermitteln. PHP stellt diesen unter $_SERVER['HTTP_REFERER'] bereit. Browser und Datenschutzeinstellungen können diesen Header jedoch weglassen, und Clients können beliebige Werte senden. Leiten Sie daher nicht ohne Prüfung auf dieses Ziel um. Der Header ist ein Hinweis in der Anfrage und kein verlässlicher Verlauf der Browserseiten. Ihre Anwendung sollte auch dann funktionieren, wenn er fehlt.

In index.php kann das Formular zusammen mit der Übermittlung eine Nachricht senden:

Der folgende vollständige home.php-Handler akzeptiert ausschließlich den lokalen Pfad /index.php. Dieses Beispiel setzt PHP 8.0 oder höher voraus, da es str_contains() verwendet. Es behält die vorhandenen Query-Parameter dieser Seite bei, fügt die übermittelte Nachricht hinzu und verwendet /index.php als Ersatzziel, wenn der Referrer fehlt oder auf einen anderen Pfad verweist. Bei einem Aufruf über die Kommandozeile verwendet das Beispiel eine Testanfrage und gibt das Umleitungsziel aus, damit sich der Erfolgsfall lokal nachvollziehen lässt. Bei einer Webanfrage sendet es eine 303-Umleitung und beendet die Ausführung.

<?php
// home.php
$isCli = PHP_SAPI === 'cli';

// Provide a sample request when running this file directly with PHP CLI.
if ($isCli) {
    $_SERVER['REQUEST_METHOD'] = 'POST';
    $_SERVER['HTTP_REFERER'] = 'https://example.test/index.php?tab=profile';
    $_POST['message'] = 'Saved.';
}

if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
    http_response_code(405);
    exit;
}

$message = $_POST['message'] ?? 'Your form was submitted.';
if (!is_string($message)) {
    $message = 'Your form was submitted.';
}

$destination = '/index.php';
$referrer = $_SERVER['HTTP_REFERER'] ?? '';
$parts = parse_url($referrer);
if (is_array($parts) && ($parts['path'] ?? '') === '/index.php') {
    $query = [];
    parse_str($parts['query'] ?? '', $query);
    $destination = '/index.php';
    if ($query !== []) {
        $destination .= '?' . http_build_query($query);
    }
}

$separator = str_contains($destination, '?') ? '&' : '?';
$target = $destination . $separator . http_build_query(['message' => $message]);

if ($isCli) {
    echo $target, PHP_EOL;
    exit;
}

header('Location: ' . $target, true, 303);
exit;

Bei der Beispielanfrage gibt der Handler dieses Umleitungsziel aus:

/index.php?tab=profile&message=Saved.

Auf der Rückkehrseite müssen Sie die Nachricht maskieren, bevor Sie sie in HTML einfügen. Prüfen Sie zuerst, ob der Query-Wert eine Zeichenfolge ist, da Query-Parameter auch als Arrays ankommen können: htmlspecialchars(is_string($_GET['message'] ?? null) ? $_GET['message'] : '', ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'). Die URL-Kodierung im Handler schützt den Query-Parameter; die HTML-Maskierung bei der Ausgabe schützt die Seite. Prüfen Sie auf Zeichenfolgen auch alle anderen Werte, die an eine Maskierungsfunktion übergeben werden, die nur Zeichenfolgen akzeptiert.

Der Handler setzt das Ziel aus dem erlaubten lokalen Pfad neu zusammen, statt den Hostnamen des Referrers zu übernehmen. So kann keine externe URL zum Umleitungsziel werden. Die Liste erlaubter Pfade ist bewusst eng gefasst: Wenn Ihre Anwendung mehrere Formularseiten hat, ordnen Sie jedem akzeptierten lokalen Pfad ausdrücklich ein Ziel zu und behalten Sie für alle übrigen Werte ein sicheres lokales Ersatzziel bei. Das Beispiel übernimmt die Query-Parameter des akzeptierten Referrers und fügt anschließend den Parameter message hinzu oder ersetzt ihn mithilfe von http_build_query(). So müssen Sie die URL-Kodierung nicht von Hand zusammensetzen und halten den Umleitungspfad von der Query-Zeichenfolge getrennt.

header() muss aufgerufen werden, bevor HTML, Leerraum oder andere Antwortinhalte ausgegeben werden. Das exit nach der Umleitung verhindert, dass späterer Handler-Code so ausgeführt wird, als wäre die Anfrage normal weitergelaufen. Der Statuscode 303 weist den Browser an, der Umleitung nach dem Formular-POST mit einer GET-Anfrage zu folgen. Der Kommandozeilenzweig dient nur der Veranschaulichung; bei einer Webanfrage sendet PHP den Antwort-Header, statt das Ziel als Seiteninhalt auszugeben. Wenn Ihre Hosting-Umgebung eine ältere PHP-Version verwendet, ersetzen Sie str_contains($destination, '?') durch eine kompatible Prüfung wie strpos($destination, '?') !== false und stellen Sie sicher, dass auch der übrige Anwendungscode diese Version unterstützt.