array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.get-browser.php', 1 => 'get_browser', 2 => 'Diz o que o navegador do usuário é capaz fazer', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Funções Miscelâneas', ), 'prev' => array ( 0 => 'function.exit.php', 1 => 'exit', ), 'next' => array ( 0 => 'function.halt-compiler.php', 1 => '__halt_compiler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Diz o que o navegador do usuário é capaz fazer

Descrição

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

Tenta determinar as capacidades do navegador do usuário, consultando as informações do navegador no arquivo browscap.ini.

Parâmetros

user_agent

O agente do usuário (navegador) a ser analisado. Por padrão, o valor do cabeçalho HTTP User-Agent é usado; no entanto, pode-se alterar isso (ou seja, procurar informações sobre outro navegador) passando este parâmetro.

Pode-se ignorar esse parâmetro com um valor null.

return_array

Se definido como true, esta função retornará um array, em vez de um object.

Valor Retornado

As informações são retornadas num objeto ou array que conterá vários elementos de dados representando, por exemplo, os números de versão principal e secundário e a string de ID; valores true/false para recursos como frames, JavaScript e cookies; e assim por diante.

O valor cookies significa simplesmente que o navegador é capaz de aceitar cookies e não significa que o usuário habilitou ou não o navegador para aceitar cookies. A única maneira de testar se os cookies são aceitos é definir um com setcookie(), recarregar, e verificar o valor.

Retorna false quando nenhuma informação puder ser obtida, como quando de configuração browscap no php.ini não tiver sido configurada.

Exemplos

Exemplo #1 Listando todas as informações sobre o navegador do usuário

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

$browser = get_browser(null, true);
print_r($browser);
?>

O exemplo acima produzirá algo semelhante 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 que isso funcione, sua diretiva de configuração browscap no php.ini deve apontar para a localização correta do arquivo browscap.ini no seu sistema.

O arquivo browscap.ini não vem com o PHP, mas pode-se encontrar um arquivo » php_browscap.ini atualizado aqui.

Embora o arquivo browscap.ini contenha informações sobre muitos navegadores, ele depende de atualizações de usuários para manter o banco de dados atualizado. O formato do arquivo é bastante autoexplicativo.