HOWTO · PHP

Volver a la página anterior en PHP

Este tutorial presenta cómo volver a la página anterior en PHP

En esta página

Para devolver al visitante a la página que contiene un formulario, lea el valor opcional HTTP_REFERER de $_SERVER, acepte únicamente un destino local autorizado y envíe un encabezado Location con header() antes de generar una respuesta. El referente no siempre está presente, así que use un destino local seguro como alternativa.

Use el encabezado de solicitud HTTP_REFERER para volver a la página anterior en PHP

Un formulario en index.php puede enviar los datos a un controlador como home.php. El navegador puede enviar la URL de la página del formulario en el encabezado de solicitud HTTP_REFERER, que PHP expone como $_SERVER['HTTP_REFERER']. Los navegadores y la configuración de privacidad pueden omitir este encabezado, y los clientes pueden proporcionar valores arbitrarios; por eso, no redirija a ese destino sin validarlo. El encabezado es una pista de la solicitud, no un registro fiable del historial del navegador. La aplicación debe seguir funcionando cuando no esté presente.

En index.php, el formulario puede enviar un mensaje junto con los datos:

<form action="home.php" method="post"><input type="hidden" name="message" value="Saved."><button type="submit">Submit</button></form>

El siguiente controlador completo home.php solo acepta la ruta local /index.php. Este ejemplo requiere PHP 8.0 o posterior porque utiliza str_contains(). Conserva los parámetros de consulta que ya tiene esa página, añade el mensaje enviado y usa /index.php como alternativa si falta el referente o apunta a otro lugar. Cuando se ejecuta desde la línea de comandos, utiliza una solicitud de ejemplo e imprime el destino de la redirección, para mostrar una ruta de éxito local útil; en una solicitud web, envía una redirección 303 y termina la ejecución.

<?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;

Para la solicitud de ejemplo, el controlador imprime este destino de redirección:

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

En la página de retorno, escape el mensaje antes de insertarlo en HTML. Primero compruebe que el valor de la consulta sea una cadena, ya que los parámetros de consulta también pueden llegar como arreglos: htmlspecialchars(is_string($_GET['message'] ?? null) ? $_GET['message'] : '', ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'). La codificación de URL del controlador protege el parámetro de consulta; el escape HTML al mostrarlo protege la página. Aplique la misma comprobación de tipo cadena a cualquier otro valor que vaya a pasar a una función de escape que solo acepte cadenas.

El controlador reconstruye el destino a partir de la ruta local autorizada, en lugar de usar el host del referente, por lo que una URL externa no puede convertirse en el destino de la redirección. La lista de rutas permitidas es deliberadamente limitada: si la aplicación tiene varias páginas con formularios, asigne explícitamente cada ruta local aceptada y mantenga una alternativa local segura para los valores que no estén en esa lista. El ejemplo conserva los parámetros de consulta del referente aceptado y luego añade o reemplaza el parámetro message mediante http_build_query(). Así se evita construir la codificación de URL a mano y se mantiene separada la ruta de redirección de su cadena de consulta.

header() debe ejecutarse antes de cualquier salida de respuesta, ya sea HTML, espacios en blanco u otro contenido. El exit que sigue a la redirección impide que el código posterior del controlador se ejecute como si la solicitud hubiera continuado normalmente. El estado 303 indica al navegador que siga la redirección con una solicitud GET después del POST del formulario. La rama de línea de comandos solo sirve como ayuda de demostración; en una solicitud web, PHP envía el encabezado de respuesta en lugar de imprimir el destino como contenido de la página. Si el entorno de alojamiento usa una versión anterior de PHP, sustituya str_contains($destination, '?') por una comprobación compatible, como strpos($destination, '?') !== false, y confirme que el resto de la aplicación también sea compatible con esa versión.