Forum und email

http_redirect

(PECL pecl_http:0.1.0-1.5.5)

http_redirect — Effectue une redirection HTTP

Description

void http_redirect ([ string $url [, array $params [, bool $session = FALSE [, int $status ]]]] )

Effectue une redirection vers l'URL fournie.

L'url fournie sera traité par la fonction http_build_url(), le paramètre params sera traité par la fonction http_build_str() et l'identifiant de session sera ajouté si le paramètre session vaut true. Vous pouvez utiliser une des constantes de redirection pour plus de confort. Repportez-vous à la » RFC 2616 pour connaître le code réponse de redirection à utiliser et dans quelle situation. Par défaut, PHP décidera quel statut à la réponse convient le mieux.

Pour rester conforme à la RFC, "Redirecting to <a>URL</a>." doit être affiché, si le client ne redirige pas immédiatement, et que la méthode de la requête était différent de HEAD.

Une entrée sera écrite dans l'historique de la redirection, si le directive de configuration INI http.log.redirect est définit et que la redirection réussit.

Liste de paramètres

url

l'URL de redirection

params

tableau associatif de paramètres de la requête

session

si l'on doit ou pas ajouter les informations de session

status

code du statut de la réponse personnalisée

Valeurs de retour

Retourne FALSE ou exits en cas de succès avec un code statut spécifique. Voir la directive de configuration INI http.force_exit pour savoir ce que signifie "exits".

Exemples

Example#1 Exemple avec http_redirect()

<?php
http_redirect
("relpath", array("name" => "value"), trueHTTP_REDIRECT_PERM);
?>

L'exemple ci-dessus va afficher :

HTTP/1.1 301 Moved Permanently
X-Powered-By: PHP/5.2.2
Content-Type: text/html
Location: https://www.example.com/curdir/relpath?name=value&PHPSESSID=abc

Redirecting to <a href="https://www.example.com/curdir/relpath?name=value&PHPSESSID=abc">https://www.example.com/curdir/relpath?name=value&PHPSESSID=abc</a>.

Voir aussi

  • la classe HttpResponse si vous utilisez PHP 5.1 et supérieur