http_redirect
(PECL pecl_http:0.1.0-1.5.5)
http_redirect — Issue HTTP redirect
说明
Redirect to the given url.
The supplied url will be expanded with http_build_url(), the params array will be treated with http_build_str() and the session identification will be appended if session is true. The HTTP response code will be set according to status . You can use one of the redirect constants for convenience. Please see » RFC 2616 for which redirect response code to use in which situation. By default PHP will decide which response status fits best.
To be RFC compliant, "Redirecting to <a>URL</a>." will be displayed, if the client doesn't redirect immediately, and the request method was another one than HEAD.
A log entry will be written to the redirect log, if the INI 设定 http.log.redirect is set and the redirect attempt was successful.
参数
- url
-
the URL to redirect to
- params
-
associative array of query parameters
- session
-
whether to append session information
- status
-
custom response status code
返回值
Returns FALSE or exits on success with the specified redirection status code. See the INI 设定 http.force_exit for what "exits" means.
范例
Example#1 A http_redirect() example
<?php
http_redirect("relpath", array("name" => "value"), true, HTTP_REDIRECT_PERM);
?>
上例将输出：
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>.
