Mobile-Detect README

The project's README from github.com/serbanghita/Mobile-Detect. As one markdown file: README.md.

Mobile Detect

MobileDetect, PHP mobile detection class

Build status Latest stable version Latest tag Monthly Downloads Total Downloads MIT License

Mobile Detect is a lightweight PHP class for detecting mobile devices (including tablets). It uses the User-Agent string combined with specific HTTP headers to detect the mobile environment.

Before you install

MobileDetect is maintained on one rolling branch per major line. Tags follow the pattern <major>.<minor>.<patch> and always live on the matching branch.

Version Tests Namespace Branch PHP Version Purpose
2.* 2.x tests \Mobile_Detect 2.x >=5.6,<7.0 Deprecated
3.* 3.x tests Detection\MobileDetect 3.x >=7.4,<8.0 LTS
4.* 4.x tests Detection\MobileDetect 4.x >=8.2 (since 4.10.0, previously >=8.0) Current, Recommended

🤝 Supporting

If you are using Mobile Detect open-source package in your production apps, in presentation demos, hobby projects, school projects or so, you can sponsor my work by donating a small amount :+1:.

I'm currently paying for domains, hosting and spend a lot of my family time to maintain the project and planning the future releases. I would highly appreciate any money donations.

Special thanks to:

📃 Documentation

The entire documentation is available on Gitbook: https://docs.mobiledetect.net

👾 Demo

Point your device to: https://demo.mobiledetect.net

🐛 Testing

vendor/bin/phpunit -v -c tests/phpunit.xml --coverage-html .coverage

🤝 Contributing

Please see the Contribute guide for details.

🔒 Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

🎉 Credits

Mobile-Detect (serbanghita/Mobile-Detect)

Searching Database…

Что это такое?Mobile Detect — это лёгкий PHP-класс, который сообщает вашему серверу, зашёл ли посетитель с мобильного устройства, включая планшеты. Он определяет это по строке User-Agent из запроса и отдельным HTTP-заголовкам.
Это библиотека, которую я подключаю в серверный код, или что-то, что ставят посетители?Это обычная PHP-библиотека: вы подключаете класс в свой серверный код, а посетители просто открывают ваш сайт как обычно — на их устройствах ничего устанавливать не нужно.
Как добавить его в свой проект?В README полное руководство по установке вынесено на Gitbook — это основной дом документации проекта. Релизы живут на отдельных скользящих ветках, по одной на каждую мажорную версию, так что вы выбираете ветку под свою версию PHP.
Нужно ли на сервере что-то помимо PHP?Нет — он работает только на основе входящего HTTP-запроса; в README среди требований не указаны ни база данных, ни PHP-расширения, ни какие-либо другие сервисы.
Есть ли подвох с версиями PHP?Да — актуальная рекомендуемая ветка 4.x рассчитана на современный PHP 8, поэтому старым приложениям остаётся легаси-ветка 2.x (она поддерживает PHP вплоть до 5.6).
Можно ли попробовать его до установки?Да — в README есть ссылка на онлайн-демо: откройте его с того устройства, которое хотите проверить, и увидите, как определяется ваш собственный телефон или планшет.
Он отличает планшеты от телефонов?Планшеты явно входят в область поддержки — класс нацелен на мобильные устройства, включая планшеты, используя те же проверки User-Agent и HTTP-заголовков.
Можно ли использовать его бесплатно в коммерческих проектах?Да — Mobile Detect распространяется по лицензии MIT, поэтому его можно бесплатно использовать в коммерческих приложениях; автор лишь просит довольных пользователей подумать о спонсировании поддержки проекта.
Проект ещё живой?Да — он существует с 2012 года, поддерживается на скользящих ветках по мажорным версиям, а в репозитории настроены CI-процессы для тестов и замеров производительности.
Size
4.3 MB
Stars
10.7K
Age
14y
Commits · 90 Days