Forum und email

get_browser

(PHP 4, PHP 5)

get_browser — Indica las capacidades del navegador del usuario

Descripción

mixed get_browser ([ string $agente_usuario [, bool $devolver_matriz ]] )

Intenta determinar las capacidades del navegador del usuario, consultando el archivo de información del navegador, browscap.ini.

Lista de parámetros

agente_usuario

El Agente de Usuario a ser analizado. Por omisión, se utiliza el valor de la cabecera HTTP User-Agent; sin embargo, puede alterar este comportamiento (es decir, consultar la información de otro navegador) pasando este parámetro.

Es posible ignorar este parámetro con un valor NULL.

devolver_matriz

Si se define como TRUE, esta función devolverá un valor tipo array en lugar de un object.

Valores retornados

La información se devuelve en un objeto o una matriz la cual contendrá varios elementos de datos que representan, por ejemplo, los números de versión mayor y menor del navegador y la cadena ID; valores TRUE/FALSE para características como los frames, JavaScript, y cookies; y así sucesivamente.

El valor cookies simplemente quiere decir que el navegador mismo tiene la capacidad de aceptar cookies y no quiere decir que el usuario haya habilitado el navegador para que acepte cookies o no. La única manera de probar si las cookies son aceptadas es definir una con setcookie(), recargar, y chequear el valor.

Registro de cambios

Versión Descripción
4.3.2 El parámetro opcional devolver_matriz fue agregado.

Ejemplos

Example#1 Listar toda la información sobre el navegador del usuario

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

$navegador get_browser(nulltrue);
print_r($navegador);
?>

El resultado del ejemplo seria 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
    [css] => 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: Para que ésto funcione, su opción de configuración browscap en php.ini debe apuntar a la ubicación correcta del archivo browscap.ini en su sistema.
browscap.ini no hace parte de la distribución de PHP, pero puede encontrar un » archivo browscap.ini actualizado aquí.
Aunque browscap.ini contiene información sobre varios navegadores, depende de actualizaciones de usuario para mantener la base de datos al día. El formato del archivo es bastante auto-explicativo.