(PHP 4, PHP 5, PHP 7, PHP 8)
get_browser — Indica las capacidades del navegador cliente
get_browser() intenta determinar las capacidades del navegador cliente. Esto se realiza leyendo las informaciones en el archivo browscap.ini.
user_agent
El encabezado user agent a analizar. Por omisión, se utiliza el valor
del encabezado User-Agent
; sin embargo,
puede alterarse (es decir, buscar otras informaciones sobre
el navegador) pasando este argumento.
Puede anularse este parámetro pasando el valor null
.
return_array
Si se define como true
, esta función retornará un tableau
en lugar de un objet.
Las informaciones se retornan en forma de un objeto, cuyos diferentes miembros contendrán informaciones, tales como las versiones mayores y menores y cadenas de identificación; booleanos para características como frames, JavaScript, y cookies; y así sucesivamente.
El valor cookies
indica simplemente que el
navegador es capaz de aceptar cookies, y no indica
si el usuario las ha activado en su navegador. El único medio
de probar la activación de cookies es establecer una
con la función setcookie(), recargar la página
y verificar que el cookie aún existe.
Retorna false
si no se puede recuperar ninguna información, tal como
cuando la opción de configuración browscap
en php.ini no ha sido definida.
Ejemplo #1 Ejemplo con get_browser(): lista de capacidades del navegador del cliente web
<?php
echo $_SERVER['HTTP_USER_AGENT'] . "\n\n";
$browser = get_browser(null, true);
print_r($browser);
?>
El resultado del ejemplo sería algo similar a:
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] => )
Nota:
Para poder funcionar, la directiva de configuración browscap en el archivo php.ini debe apuntar al archivo browscap.ini del sistema.
browscap.ini no se distribuye con PHP, pero puede descargarse en » php_browscap.ini.
Aunque browscap.ini contiene informaciones sobre un gran número de navegadores, corresponde al usuario mantener su base de datos actualizada. El formato del archivo es muy sencillo de comprender.