get_browser
(PHP 4, PHP 5)
get_browser — Indica las capacidades del navegador del usuario
Descripción
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(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] => )
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.