http_request
http_send_content_disposition
HTTP Funktionen
PHP Manual

# http_redirect

(PECL pecl_http >= 0.1.0)

http_redirect — Issue HTTP redirect

### Beschreibung

bool http_redirect ([ string `$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-Einstellungen http.log.redirect is set and the redirect attempt was successful.

### Parameter-Liste

`url`

  the URL to redirect to

`params`

  associative array of query parameters

`session`

  whether to append session information

`status`

  custom response status code

### Rückgabewerte

Liefert `FALSE` oder beendet bei Erfolg with the specified redirection status code. INI-Einstellungen http.force_exit beschreibt, was "exits" bedeutet.

### Beispiele

Beispiel #1 A http_redirect() example

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

### Siehe auch

- die HttpResponse-Klasse, wenn sie PHP 5.1 oder höher benutzen

http_request
http_send_content_disposition
HTTP Funktionen
PHP Manual