PHP Handbuch
Zurück |  | Nach vorne

# get_browser

(PHP 3, PHP 4 )

get_browser -- Ermittelt die Möglichkeiten des Browsers eines Benutzers

## Beschreibung:

object get_browser ( [string user_agent])

get_browser() ermittelt die Möglichkeiten des auf das PHP-Skript zugreifenden Browsers. Dies geschieht durch Auslesen der zum Browser vorhandenen Werte aus der Datei `browscap.ini`. Per Voreinstellung wird der Wert von $HTTP_USER_AGENT als Browser-Typ benutzt. Dieses Verhalten können sie ändern (so z.B. den Namen der INI-Datei), indem sie den optionalen `user_agent`-Parameter an die get_browser()-Funktion übergeben.

Die zurück gegebene Information ist ein Objekt, das verschiedene Datenelemente enthält. Dazu gehören z.B. die Haupt- und Unterversions-Nummer des Browsers sowie `TRUE` / false-Werte für Browser-Fähigkeiten (u.a. Frame-, Java- und Cookies-Unterstützung). Nicht gemeint ist hier die aktuell vorhandene Nutzung. Ist der Browser so konfiguriert, dass er z.Zt. keine Cookies annehmen soll, wird trotzdem `TRUE` in Bezug auf die Cookie-Fähigkeiten zurückgegeben, wenn in der Datei `browscap.ini` der entsprechende Wert `TRUE` ist.

Da in `browscap.ini` Informationen vieler Browser stehen, obliegt es dem Skript-Schreiber, diese Datei auf dem Laufenden zu halten. Das Format dieser Datei sollte selbsterklärend sein.

Das folgende Beispiel zeigt, wie man alle verfügbaren Informationen zu einem gerade benutzten Browser anzeigen könnte:

Beispiel 1. get_browser()-Beispiel:
    <?php
    function list_array ($array) {
        while (list ($key, $value) = each ($array)) {
            $str .= "<b>$key:</b> $value<br>\n";
        }
        return $str;
    }
    echo "$HTTP_USER_AGENT<hr>\n";
    $browser = get_browser();
    echo list_array ((array) $browser);
    ?>

Die Ausgabe des obigen Skripts könnte so aussehen:

    Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr>
    <b>browser_name_pattern:</b> Mozilla/4\.5.*<br>
    <b>parent:</b> Netscape 4.0<br>
    <b>platform:</b> Unknown<br>
    <b>majorver:</b> 4<br>
    <b>minorver:</b> 5<br>
    <b>browser:</b> Netscape<br>
    <b>version:</b> 4<br>
    <b>frames:</b> 1<br>
    <b>tables:</b> 1<br>
    <b>cookies:</b> 1<br>
    <b>backgroundsounds:</b> <br>
    <b>vbscript:</b> <br>
    <b>javascript:</b> 1<br>
    <b>javaapplets:</b> 1<br>
    <b>activexcontrols:</b> <br>
    <b>beta:</b> <br>
    <b>crawler:</b> <br>
    <b>authenticodeupdate:</b> <br>
    <b>msn:</b> <br>

Damit dieses Skript richtig funktioniert, muss die browscap-Einstellung ihrer Konfigurations-Datei auf die richtige `browscap.ini`-Datei zeigen.

Weitere Informationen (incl. Bezugsquellen für `browscap.ini`-Dateien) finden sie in der PHP-FAQ unter http://www.php.net/FAQ.php.

Zurück | Zum Anfang | Nach vorne
exit | Nach oben | highlight_file