exit
__halt_compiler
Sonstige Funktionen
PHP Manual

# get_browser

(PHP 4, PHP 5)

get_browser — Ermittelt die Fähigkeiten des Browsers eines Benutzers

### Beschreibung

mixed get_browser ([ string `$user_agent` [, bool `$return_array` ]] )

Diese Funktion versucht die Fähigkeiten des Browsers des Benutzers zu ermitteln, indem sie die Informationen über den Browser aus der Datei browscap.ini ausliest.

### Parameter-Liste

`user_agent`

  Der User-Agent, der analysiert werden soll. Per Voreinstellung wird der Wert des HTTP User-Agent-Headers verwendet, jedoch können Sie das ändern, d.h. Informationen über einen anderen Browser nachschlagen, indem Sie diesen Parameter übegeben.

  Dieser Parameter kann mit einem `NULL`-Wert umgangen werden.

`return_array`

  Falls dieser Parameter auf `TRUE` gesetzt wird, gibt diese Funktion statt eines Objekts ein Array zurück.

### Rückgabewerte

Die Informationen werden in einem Objekt oder Array zurückgegeben, das verschiedene Datenelemente enthält. Dazu gehören z.B. die Haupt- und Unterversions-Nummer und Kennung des Browsers sowie `TRUE`/`FALSE`-Werte für dessen Fähigkeiten, wie z.B. Frames, JavaScript, Cookies usw.

Der Wert von cookies sagt nur etwas darüber aus, ob der Browser an sich in der Lage ist Cookies anzunehmen, und nicht darüber, ob der Benutzer die Annahme von Cookies aktiviert hat. Die einzige Möglichkeit zu testen, ob Cookies akzeptiert werden, besteht darin, mittels setcookie() ein Cookie zu setzen, die Seite neu zu laden und dessen Wert zu überprüfen.

### ChangeLog

Version | Beschreibung
--- | ---
4.3.2 | Der optionale Parameter `return_array` wurde hinzugefügt.

### Beispiele

Beispiel #1 Auflistung aller Informationen über den Browser des Benutzers

`<?php
echo $_SERVER['HTTP_USER_AGENT'] . "\n\n";
$browser = get_browser(null, true);
print_r($browser);
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040803 Firefox/0.9.3

    Array
    (
        [browser_name_regex] => ^mozilla/5\.0 (windows; .; windows nt 5\.1; .*rv:.*) gecko/.* firefox/0\.9.*$
        [browser_name_pattern] => Mozilla/5.0 (Windows; ?; Windows NT 5.1; *rv:*) Gecko/* Firefox/0.9*
        [parent] => Firefox 0.9
        [platform] => WinXP
        [browser] => Firefox
        [version] => 0.9
        [majorver] => 0
        [minorver] => 9
        [css] => 2
        [frames] => 1
        [iframes] => 1
        [tables] => 1
        [cookies] => 1
        [backgroundsounds] =>
        [vbscript] =>
        [javascript] => 1
        [javaapplets] => 1
        [activexcontrols] =>
        [cdf] =>
        [aol] =>
        [beta] => 1
        [win16] =>
        [crawler] =>
        [stripper] =>
        [wap] =>
        [netclr] =>
    )

### Anmerkungen

> Hinweis: Damit es richtig funktioniert, muss die browscap-Einstellung Ihrer php.ini auf die richtige browscap.ini-Datei Ihres Systems zeigen.
> browscap.ini ist nicht Bestandteil von PHP, aber eine aktuelle » php_browscap.ini bekommen Sie hier.
> Da die browscap.ini Informationen zu vielen Browsern enthält, obliegt es dem Skript-Schreiber, diese Datei auf dem Laufenden zu halten. Das Format dieser Datei sollte selbsterklärend sein.

exit
__halt_compiler
Sonstige Funktionen
PHP Manual