array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.get-browser.php', 1 => 'get_browser', 2 => 'Indique les capacités du navigateur client', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Fonctions diverses', ), 'prev' => array ( 0 => 'function.exit.php', 1 => 'exit', ), 'next' => array ( 0 => 'function.halt-compiler.php', 1 => '__halt_compiler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/misc/functions/get-browser.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

get_browser

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

get_browser — Indique les capacités du navigateur client

Description

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

get_browser() essaie de déterminer les capacités du navigateur client. Cela se fait en lisant les informations dans le fichier browscap.ini.

Liste de paramètres

user_agent

L'entête user agent à analyser. Par défaut, la valeur de l'en-tête User-Agent est utilisé; cependant, il est possible de l'altérer (c.-à-d. cherche d'autres informations sur le navigateur) en passant ce paramètre.

Il est possible d'annuler ce paramètre en y passant la valeur null.

return_array

Si défini à true, cette fonction retournera un tableau au lieu d'un objet.

Valeurs de retour

Les informations sont retournées sous forme d'un objet, dont les différents membres contiendront des informations, telles que les versions majeures et mineures et des chaînes d'identification ; des booléens pour des caractéristiques telles que frames, JavaScript, et cookies ; et ainsi de suite.

La valeur cookies indique simplement que le navigateur est capable d'accepter les cookies, et n'indique pas si l'utilisateur les a activé sur son navigateur. Le seul moyen de tester l'activation des cookies est d'en poser un avec la fonction setcookie(), de recharger la page et de vérifier que le cookie existe toujours.

Retourne false si aucune information ne peut être récupérée, tel que quand l'option de configuration browscap dans php.ini n'a pas été définie.

Exemples

Exemple #1 Exemple avec get_browser() : liste des capacités du navigateur du client web

<?php
echo $_SERVER['HTTP_USER_AGENT'] . "\n\n";

$browser = get_browser(null, true);
print_r($browser);
?>

Résultat de l'exemple ci-dessus est similaire à :

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] =>
)

Notes

Note:

Afin de pouvoir fonctionner, la directive de configuration browscap dans le fichier php.ini doit pointer vers le fichier browscap.ini du système.

browscap.ini n'est pas distribué avec PHP, mais il est possible de le télécharger sur » php_browscap.ini.

Bien que browscap.ini contienne des informations sur de très nombreux navigateurs, il incombe à l'utilisateur de conserver sa base de données à jour. Le format du fichier est très simple à comprendre.