Base de conhecimento

1000 perguntas frequentes, 500 tutoriais e vídeos explicativos. Aqui, você encontra apenas soluções!

Usar o arquivo browscap.ini

Atualização 06/08/2026

Este guia apresenta a função do arquivo browscap.ini, utilizado pelo PHP para identificar certas características de um navegador web (nome, versão, sistema operacional e capacidades) a partir do seu cabeçalho HTTP User-Agent.

Atualmente, o uso de browscap.ini destina-se principalmente a garantir a compatibilidade com aplicações existentes. Para novos desenvolvimentos, métodos mais modernos são geralmente preferidos.

 

Utilização com a função get_browser()

A função nativa do PHP get_browser() requer acesso a um arquivo browscap.ini atualizado para identificar as características do navegador que fez a solicitação.

Nos serviços de hospedagem web da Infomaniak, este arquivo geralmente está disponível no seguinte local:

/opt/php/lib/php/browscap.ini

Se necessário, pode verificar o conteúdo utilizando o seguinte script:

<?php
header('Content-Type: text/plain');

$file = '/opt/php/lib/php/browscap.ini';

if (file_exists($file)) {
    echo file_get_contents($file);
} else {
    echo 'Arquivo não encontrado.';
}

Devido ao seu tamanho e ao custo do seu carregamento, o uso de browscap.ini pode ter um impacto no desempenho das aplicações que dependem de get_browser().

 

Alternativas recomendadas

Para novos projetos, geralmente é preferível usar soluções mais adequadas às práticas atuais de desenvolvimento web:

  • Bibliotecas PHP instaladas com o Composer, como matomo/device-detector ou whichbrowser/parser, que oferecem uma detecção de navegadores e dispositivos mais completa e regularmente atualizada.
  • Dicas do Agente do Usuário (UA-CH), quando o navegador as suporta, para obter informações estruturadas por meio dos mecanismos previstos pelos padrões HTTP atuais.
  • Detecção de recursos, verificando diretamente a disponibilidade de um recurso (por exemplo, em JavaScript ou com a regra CSS @supports) em vez de deduzir o comportamento com base no navegador utilizado.

Link para esta FAQ: https://faq.infomaniak.com/505


Esta seção de perguntas frequentes foi útil?