http_redirect
(PECL pecl_http >= 0.1.0)
http_redirect — Issue HTTP redirect
說明
$url
[, array $params
[, bool $session = false
[, int $status = 0
]]]] )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
回傳值
回傳 FALSE 或在成功時回傳出口訊息 with the specified redirection status code.
要知道“出口”的含意請查閱
INI 設定
http.force_exit。
範例
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>.
add a note
