# get_browser

(PHP 4, PHP 5, PHP 7, PHP 8)

get_browser — Ermittelt die Fähigkeiten des Browsers eines Benutzers

### Beschreibung

get_browser(?string `$user_agent` = `null`, bool `$return_array` = `false`): object|array|false

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

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

`return_array`

  Falls dieser Parameter auf `true` gesetzt wird, gibt die 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 Unter-Versionsnummer und Kennung des Browsers sowie `true`/`false`-Werte für dessen Fähigkeiten, 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.

Gibt `false` zurück, wenn keine Informationen abgerufen werden können, z. B. wenn die Konfigurationseinstellung browscap in der php.ini nicht gesetzt wurde.

### 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
        [cssversion] => 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.

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open