(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
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,
vous pouvez l'altérer (i.e. cherche d'autres informations sur
le navigateur) en passant ce paramètre.
Vous pouvez annuler ce paramètre en y passant la valeur null
.
-
return_array
-
Si définit à 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é, 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 de votre
système.
browscap.ini n'est pas distribué avec PHP, mais vous
pouvez le télécharger sur
» php_browscap.ini.
Bien que browscap.ini contienne des informations
sur de très nombreux navigateur, il incombe à l'utilisateur de
conserver sa base de données à jour. Le format du fichier
est très simple à comprendre.