http_redirect
(PECL pecl_http >= 0.1.0)
http_redirect — Effectue une redirection HTTP
Description
$url
[, array $params
[, bool $session
= false
[, int $status
= 0
]]]] )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.
Reportez-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éfini 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
Exemple #1 Exemple avec http_redirect()
<?php http_redirect("relpath", array("name" => "value"), true, HTTP_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: http://www.example.com/curdir/relpath?name=value&PHPSESSID=abc Redirecting to <a href="http://www.example.com/curdir/relpath?name=value&PHPSESSID=abc">http://www.example.com/curdir/relpath?name=value&PHPSESSID=abc</a>.