- get_browser
- Список параметров
- Возвращаемые значения
- Примеры
- Примечания
- Something Useful
- strpos() must have returned non-false
- strpos() must have returned false
- strpos() must have returned non-false
- Как получить User Agent в PHP. Как настроить browscap.ini
- Как настроить PHP для работы с get_browser
- Связанные статьи:
get_browser
Пытается определить возможности браузера пользователя производя поиск информации о браузере в файле browscap.ini .
Список параметров
Анализируется User Agent. По умолчанию, используется значение HTTP User-Agent. Тем не менее этот параметр можно пропустить для получения дополнительной информации о браузере.
Параметр может быть пропущен, если его значение будет равно NULL .
Если равен TRUE , то функция вернет массив ( array )вместо объекта ( object ).
Возвращаемые значения
Информация возвращается в виде объекта, либо в виде архива, который содержит различные данные, к примеру, мажорную и минорную версию браузера и строку ID; TRUE / FALSE наличие функций браузера, таких как фреймы, JavaScript, cookies и т.д.
Наличие cookies означает, что браузер имеет возможность приёма cookies, а не сообщает о том, включил ли пользователь возможность приёма cookies или нет. Единственным способом проверки возможности браузера принимать cookies является установка cookie с помощью setcookie() , обновление страницы и проверка значения.
Примеры
Пример #1 Вывод информации о браузере пользователя
echo $_SERVER [ ‘HTTP_USER_AGENT’ ] . «\n\n» ;
?php
$browser = get_browser ( null , true );
print_r ( $browser );
?>
Результатом выполнения данного примера будет что-то подобное:
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] => )
Примечания
Замечание:
Для работы этой функции необходимо, чтобы в установке browscap в настройках php.ini был установлен корректный путь к файлу browscap.ini в вашей системе.
browscap.ini не поставляется с PHP, но вы можете последнюю его версию здесь: » php_browscap.ini.
browscap.ini содержит информацию о большинстве браузеров, он требует обновлений для поддержания его базы актуальной Формат файла довольно очевиден.
Something Useful
Let us do something more useful now. We are going to check what sort of browser the visitor is using. For that, we check the user agent string the browser sends as part of the HTTP request. This information is stored in a variable. Variables always start with a dollar-sign in PHP. The variable we are interested in right now is $_SERVER[‘HTTP_USER_AGENT’] .
Note:
$_SERVER is a special reserved PHP variable that contains all web server information. It is known as a superglobal. See the related manual page on superglobals for more information.
To display this variable, you can simply do:
Example #1 Printing a variable (Array element)
A sample output of this script may be:
There are many types of variables available in PHP. In the above example we printed an Array element. Arrays can be very useful.
$_SERVER is just one variable that PHP automatically makes available to you. A list can be seen in the Reserved Variables section of the manual or you can get a complete list of them by looking at the output of the phpinfo() function used in the example in the previous section.
You can put multiple PHP statements inside a PHP tag and create little blocks of code that do more than just a single echo. For example, if you want to check for Internet Explorer you can do this:
Example #2 Example using control structures and functions
if ( strpos ( $_SERVER [ ‘HTTP_USER_AGENT’ ], ‘MSIE’ ) !== FALSE ) echo ‘You are using Internet Explorer.
‘ ;
>
?>?php
A sample output of this script may be:
You are using Internet Explorer.
Here we introduce a couple of new concepts. We have an if statement. If you are familiar with the basic syntax used by the C language, this should look logical to you. Otherwise, you should probably pick up an introductory PHP book and read the first couple of chapters, or read the Language Reference part of the manual.
The second concept we introduced was the strpos() function call. strpos() is a function built into PHP which searches a string for another string. In this case we are looking for ‘MSIE’ (so-called needle) inside $_SERVER[‘HTTP_USER_AGENT’] (so-called haystack). If the needle is found inside the haystack, the function returns the position of the needle relative to the start of the haystack. Otherwise, it returns false . If it does not return false , the if expression evaluates to true and the code within its is executed. Otherwise, the code is not run. Feel free to create similar examples, with if, else, and other functions such as strtoupper() and strlen() . Each related manual page contains examples too. If you are unsure how to use functions, you will want to read both the manual page on how to read a function definition and the section about PHP functions.
We can take this a step further and show how you can jump in and out of PHP mode even in the middle of a PHP block:
Example #3 Mixing both HTML and PHP modes
if ( strpos ( $_SERVER [ ‘HTTP_USER_AGENT’ ], ‘MSIE’ ) !== FALSE ) ?>
strpos() must have returned non-false
You are using Internet Explorer
> else ?>
strpos() must have returned false
You are not using Internet Explorer
>
?>?php
A sample output of this script may be:
strpos() must have returned non-false
You are using Internet Explorer
Instead of using a PHP echo statement to output something, we jumped out of PHP mode and just sent straight HTML. The important and powerful point to note here is that the logical flow of the script remains intact. Only one of the HTML blocks will end up getting sent to the viewer depending on the result of strpos() . In other words, it depends on whether the string MSIE was found or not.
Как получить User Agent в PHP. Как настроить browscap.ini
User Agent — это строка, которая характеризует программу, делающую запрос к веб-серверу. Пример такой строки:
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36
Как можно увидеть, по User Agent можно определить операционную систему и версию веб-браузера.
По своей сути User Agent является одним из заголовков протокола HTTP. Причём этот заголовок присылает сам клиент. Отсюда очень важное следствие — строка User Agent может быть подменена на абсолютно любое значение или отсутствовать вовсе. В веб-браузерах это можно сделать с помощью плагинов.
Поэтому всегда помните о том, что Пользовательский Агент может быть спуфлен (заменён). Причём если вы, например, сохраняете полученные значения в базу данных, то помните о необходимости фильтрации данных, поскольку без должной фильтрации пользовательских данных это может стать причиной уязвимости SQL-инъекция.
Итак, получить значение User Agent в PHP скрипте можно используя переменную $_SERVER[‘HTTP_USER_AGENT’]. Например:
Как настроить PHP для работы с get_browser
Ещё один способ — это использовать функцию get_browser. На самом деле, суть функции get_browser в том, чтобы показать возможности (поддерживаемые технологии) веб-браузера на основе User Agent. Причём необязательно для текущего пользователя — функция get_browser может в качество ввода принимать произвольную строку User Agent.
По умолчанию функция get_browser НЕ работает, поскольку требует дополнительной настройки в конфигурации PHP. Если не выполнить эту настройку, то при попытке использовать функцию get_browser вы будете получать примерно такое предупреждение:
Warning: get_browser(): browscap ini directive not set in /srv/http/tests.php on line 5
Точнее говоря, требуется скачать специальный файл с перечнем свойств веб-браузера и указать путь до него в php.ini (главном конфигурационном файле PHP).
Эти файлы размещены на сайте http://browscap.org/. Всего для PHP имеется 3 варианта:
- php_browscap.ini (17,095 KB). Стандартная версия файла, довольно полная.
- full_php_browscap.ini (85,513 KB). Самая большая версия файла со всеми возможными свойствами.
- lite_php_browscap.ini (463 KB). Облегчённый вариант, содержит основные браузеры и поисковые движки. Этот файл вполне подойдёт для большинства веб-сайтов.
Итак, скачайте один из этих файлов — тот, который больше подходит под ваши нужды.
Для примера я скачал файл full_php_browscap.ini. Переименуйте скаченный файл в browscap.ini.
Переместите этот файл в директорию /etc/php/
Теперь откройте файл /etc/php/php.ini. Найдите там раздел:
[browscap] ; http://php.net/browscap ;browscap = extra/browscap.ini
Удалите вторую строку, а третью раскомментируйте и в качестве значения укажите абсолютный путь до файла, чтобы получилось так:
[browscap] browscap = /etc/php/browscap.ini
ПРИМЕЧАНИЕ: В некоторых дистрибутивах путь до файла php.ini иной и зависит от версии PHP. К примеру, сейчас в Debian путь до файла следующий: /etc/php/8.1/apache2/php.ini
Чтобы изменения вступили в силу, перезапустите веб-сервер Apache.
На Debain, Ubuntu, Linux Mint, Kali Linux и их производных:
sudo systemctl restart apache2.service
На Arch Linux, BlackArch и их производных:
sudo systemctl restart httpd.service
Array ( [browser_name_regex] => ~^mozilla/5\.0 \(.*linux.*x86_64.*\).*applewebkit.*\(.*khtml.*like.*gecko.*\).*chrome/.* safari/.*$~ [browser_name_pattern] => Mozilla/5.0 (*Linux*x86_64*)*applewebkit*(*khtml*like*gecko*)*Chrome/* Safari/* [parent] => Chrome Generic [browser_bits] => 64 [platform] => Linux [platform_description] => Linux [platform_bits] => 64 [platform_maker] => Linux Foundation [device_name] => Linux Desktop [device_code_name] => Linux Desktop [comment] => Chrome Generic [browser] => Chrome [browser_type] => Browser [browser_maker] => Google Inc [frames] => 1 [iframes] => 1 [tables] => 1 [cookies] => 1 [javascript] => 1 [cssversion] => 3 [aolversion] => 0 [device_type] => Desktop [device_pointing_method] => mouse [renderingengine_name] => Blink [renderingengine_description] => a WebKit Fork by Google [renderingengine_maker] => Google Inc [browser_modus] => unknown [version] => 0.0 [majorver] => 0 [minorver] => 0 [platform_version] => unknown [alpha] => [beta] => [win16] => [win32] => [win64] => [backgroundsounds] => [vbscript] => [javaapplets] => [activexcontrols] => [ismobiledevice] => [istablet] => [issyndicationreader] => [crawler] => [isfake] => [isanonymized] => [ismodified] => [device_maker] => unknown [device_brand_name] => unknown [renderingengine_version] => unknown )
Обратите внимание, что в последних версиях PHP драмматически (в сотню раз) увеличена скорость работы функции get_browser.
При выборе нужного файла browscap.ini помните об их размерах, поскольку облегчённая версия от самой полной по размеру отличается примерно в 200 раз! При этом помните о расходе оперативной памяти на каждый процесс веб-сервера. Причём может быть повышенной потребление оперативной памяти даже если вы фактически не используете функцию get_browser.
Также помните о том, что вам нужно заботиться об обновлении файла browscap.ini.