get_browser

(PHP 3, PHP 4, PHP 5)

get_browser --  Indica las capacidades del navegador del usuario

Descripción

mixed get_browser ( [string agente_usuario [, bool matriz_retorno]] )

get_browser() intenta determinar las capacidades del navegador del usuario. Para ello consulta el archivo de información del navegador, browscap.ini.

Por defecto, se utiliza el valor de $_SERVER['HTTP_USER_AGENT']; sin embargo, puede alterar este comportamiento (es decir, consultar la información de otro navegador) pasando el parámetro opcional agente_usuario a get_browser(). Es posible ignorar el parámetro agente_usuario con el valor NULL.

La información se devuelve en un object, el 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.

A partir de PHP 4.3.2, si el parámetro opcional matriz_retorno es TRUE, esta función devuelve un valor array en lugar de object.

Ejemplo 1. Listar toda la información sobre el navegador del usuario

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

$navegador = get_browser(null, true);
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] => 
)

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.

Nota: 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.

Hosting by: hurra.com
Generated: 2007-01-26 18:00:42