array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.get-browser.php', 1 => 'get_browser', 2 => 'Indica las capacidades del navegador cliente', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Funciones Varias', ), 'prev' => array ( 0 => 'function.exit.php', 1 => 'exit', ), 'next' => array ( 0 => 'function.halt-compiler.php', 1 => '__halt_compiler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/misc/functions/get-browser.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

get_browser

(PHP 4, PHP 5, PHP 7, PHP 8)

get_browser — Indica las capacidades del navegador cliente

Descripción

get_browser(?string $user_agent = null, bool $return_array = false): object|array|false

get_browser() intenta determinar las capacidades del navegador cliente. Esto se realiza leyendo las informaciones en el archivo browscap.ini.

Parámetros

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 array en lugar de un object.

Valores devueltos

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.

Ejemplos

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);
?>

Resultado del ejemplo anterior es 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] =>
)

Notas

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.