get_browser
(PHP 4, PHP 5, PHP 7, PHP 8)
get_browser — Ermittelt die Fähigkeiten des Browsers eines Benutzers
Beschreibung
$user_agent = null, bool $return_array = false): object|array|falseDiese 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
truegesetzt 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.
