Manual do PHP
Anterior |  | Próxima

# http_redirect

(PECL)

http_redirect -- Issue HTTP redirect

## Descrição

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

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 Definições INI http.log.redirect is set and the redirect attempt was successful.

## Parâmetros

`url`

  the URL to redirect to

`params`

  associative array of query parameters

`session`

  whether to append session information

`status`

  custom response status code

## Valores de retornado

Returns `FALSE` or exits on success with the specified redirection status code. See the Definições INI http.force_exit for what "exits" means.

## Exemplos

Exemplo 1. A http_redirect() example

`<?php http_redirect("relpath", array("name" => "value"), true, HTTP_REDIRECT_PERM); ?>`

O exemplo acima irá imprimir:

    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>.

## Veja também

the HttpResponse class if you are using PHP-5.1 and above

Anterior | Principal | Próxima
http_request_body_encode | Acima | http_send_content_disposition