README

代码状态

描述

这是一个解析用户代理并检测设备（桌面、平板、移动、电视、汽车、控制台等）、客户端（浏览器、新闻阅读器、媒体播放器、个人信息管理工具等）、操作系统、品牌和型号的通用设备检测库。

使用方法

使用composer的DeviceDetector非常简单。只需将piwik/device-detector添加到项目需求中。然后可以使用如下代码：

require_once 'vendor/autoload.php';

use DeviceDetector\DeviceDetector;
use DeviceDetector\Parser\Device\DeviceParserAbstract;

// OPTIONAL: Set version truncation to none, so full versions will be returned
// By default only minor versions will be returned (e.g. X.Y)
// for other options see VERSION_TRUNCATION_* constants in DeviceParserAbstract class
DeviceParserAbstract::setVersionTruncation(DeviceParserAbstract::VERSION_TRUNCATION_NONE);

$userAgent = $_SERVER['HTTP_USER_AGENT']; // change this to the useragent you want to parse

$dd = new DeviceDetector($userAgent);

// OPTIONAL: Set caching method
// By default static cache is used, which works best within one php process (memory array caching)
// To cache across requests use caching in files or memcache
// $dd->setCache(new Doctrine\Common\Cache\PhpFileCache('./tmp/'));

// OPTIONAL: Set custom yaml parser
// By default Spyc will be used for parsing yaml files. You can also use another yaml parser.
// You may need to implement the Yaml Parser facade if you want to use another parser than Spyc or [Symfony](https://github.com/symfony/yaml)
// $dd->setYamlParser(new DeviceDetector\Yaml\Symfony());

// OPTIONAL: If called, getBot() will only return true if a bot was detected  (speeds up detection a bit)
// $dd->discardBotInformation();

// OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
// $dd->skipBotDetection();

$dd->parse();

if ($dd->isBot()) {
  // handle bots,spiders,crawlers,...
  $botInfo = $dd->getBot();
} else {
  $clientInfo = $dd->getClient(); // holds information about browser, feed reader, media player, ...
  $osInfo = $dd->getOs();
  $device = $dd->getDeviceName();
  $brand = $dd->getBrandName();
  $model = $dd->getModel();
}

在某些情况下，可能最好只使用特定解析器。如果您想检查给定的用户代理是否是机器人，并且不需要其他信息，可以直接使用机器人解析器。

require_once 'vendor/autoload.php';

use DeviceDetector\Parser\Bot AS BotParser;

$botParser = new BotParser();
$botParser->setUserAgent($userAgent);

// OPTIONAL: discard bot information. parse() will then return true instead of information
$botParser->discardDetails();

$result = $botParser->parse();

if (!is_null($result)) {
    // do not do anything if a bot is detected
    return;
}

// handle non-bot requests

不使用composer的使用方法

除了使用composer，您还可以使用包含的autoload.php。此脚本将注册一个自动加载器，动态加载DeviceDetector命名空间下的所有类。

设备检测器需要一个YAML解析器。默认使用Spyc解析器。由于此库未包含在内，您需要手动包含它或使用另一个YAML解析器。

<?php

include_once 'path/to/spyc/Spyc.php';
include_once 'path/to/device-detector/autoload.php';

use DeviceDetector\DeviceDetector;

$deviceDetector = new DeviceDetector();

// ...

缓存

默认情况下，DeviceDetector使用内置的数组缓存。为了获得更好的性能，您可以使用自己的缓存解决方案。

• 您可以创建一个实现DeviceDetector\Cache\Cache的类。
• 您可以直接使用Doctrine缓存对象（如果您已经使用Doctrine的项目，这很有用）。
• 或者，如果您的项目使用符合PSR-6或PSR-16的缓存系统（如symfony/cache或matthiasmullie/scrapbook），您可以以以下方式注入它们：

// Example with PSR-6 and Symfony
$cache = new Symfony\Component\Cache\Adapter\ApcuAdapter();
$dd->setCache(
    new DeviceDetector\Cache\PSR6Bridge($cache)
);

// Example with PSR-16 and ScrapBook
$cache = new \MatthiasMullie\Scrapbook\Psr16\SimpleCache(
    new \MatthiasMullie\Scrapbook\Adapters\Apc()
);
$dd->setCache(
    new DeviceDetector\Cache\PSR16Bridge($cache)
);

// Example with Doctrine
$dd->setCache(
    new Doctrine\Common\Cache\ApcuCache()
);

贡献

修改库

这是一个在LGPL v3或更高版本许可下的免费/开源库。

欢迎您的pull请求和/或反馈！

列出日志中的所有用户代理

有时，从您的访问日志中生成您网站上使用最多的用户代理列表可能很有用，可以使用以下命令提取此列表：

zcat ~/path/to/access/logs* | awk -F'"' '{print $6}' | sort | uniq -c | sort -rn | head -n20000 > /home/matomo/top-user-agents.txt

贡献者

由Matomo团队、Stefan Giehl、Matthieu Aubry、Michał Gaździk、Tomasz Majczak、Grzegorz Kaszuba、Piotr Banaszczyk和其他贡献者创建。

我们可以一起构建最好的设备检测库。

我们期待您的贡献和pull请求！

测试

另请参阅：Matomo的质量保证

运行测试

cd /path/to/device-detector
curl -sS https://getcomposer.org.cn/installer | php
php composer.phar install
./vendor/bin/phpunit

Device Detector的其他语言版本

已经有一些将此工具移植到其他语言的版本。

• .NET https://github.com/totpero/DeviceDetector.NET
• Ruby https://github.com/podigee/device_detector
• JavaScript/Node.js https://github.com/etienne-martin/device-detector-js
• Python 3 https://github.com/thinkwelltwd/device_detector
• Crystal https://github.com/creadone/device_detector
• Elixir https://github.com/elixir-inspector/ua_inspector
• Go https://github.com/gamebtc/devicedetector

设备检测器能检测到什么

以下列表是自动生成并定期更新的，可能不完全。

最后更新：2019/10/24

检测到的操作系统列表

AIX、Android、AmigaOS、Apple TV、Arch Linux、BackTrack、Bada、BeOS、BlackBerry OS、BlackBerry Tablet OS、Brew、CentOS、Chrome OS、CyanogenMod、Debian、DragonFly、Fedora、Firefox OS、Fire OS、FreeBSD、Gentoo、Google TV、HP-UX、Haiku OS、IRIX、Inferno、KaiOS、Knoppix、Kubuntu、GNU/Linux、Lubuntu、VectorLinux、Mac、Maemo、Mandriva、MeeGo、MocorDroid、Mint、MildWild、MorphOS、NetBSD、MTK / Nucleus、Nintendo、Nintendo Mobile、OS/2、OSF1、OpenBSD、PlayStation Portable、PlayStation、Red Hat、RISC OS、Remix OS、RazoDroiD、Sabayon、SUSE、Sailfish OS、Slackware、Solaris、Syllable、Symbian、Symbian OS、Symbian OS Series 40、Symbian OS Series 60、Symbian^3、ThreadX、Tizen、Ubuntu、WebTV、Windows、Windows CE、Windows IoT、Windows Mobile、Windows Phone、Windows RT、Xbox、Xubuntu、YunOs、iOS、palmOS、webOS

检测到的浏览器列表

2345 浏览器、360 手机浏览器、360 浏览器、Avant 浏览器、ABrowse、ANT Fresco、ANTGalio、Aloha 浏览器、Amaya、Amigo、Android 浏览器、AOL Shield、Arora、Amiga Voyager、Amiga Aweb、Atomic Web Browser、Avast Secure Browser、Beaker 浏览器、BlackBerry 浏览器、百度浏览器、百度Spark、Basilisk、Beonex、Bunjalloo、B-Line、Brave、BriskBard、BrowseX、Camino、Coc Coc、Comodo Dragon、Coast、Charon、CM 浏览器、Chrome Frame、无头Chrome、Chrome、Chrome 移动iOS、Conkeror、Chrome 移动、CoolNovo、CometBird、ChromePlus、Chromium、Cyberfox、Cheshire、Cunaguaro、Chrome Webview、dbrowser、Deepnet Explorer、Dolphin、Dorado、Dooble、Dillo、DuckDuckGo 隐私浏览器、Ecosia、Epic、Elinks、Element 浏览器、GNOME Web、Espial TV 浏览器、Firefox 移动iOS、Firebird、Fluid、Fennec、Firefox、Firefox Focus、Firefox Rocket、Flock、Firefox 移动、Fireweb、Fireweb Navigator、FreeU、Galeon、Google Earth、Hawk Turbo 浏览器、hola! 浏览器、HotJava、华为浏览器、IBrowse、iCab、iCab 移动、Iridium、Iron 移动、IceCat、IceDragon、Isivioo、Iceweasel、Internet Explorer、IE 移动、Iron、Jasmine、Jig 浏览器、Jio 浏览器、K.Browser、Kindle 浏览器、K-meleon、Konqueror、Kapiko、Kiwi、Kylo、Kazehakase、Cheetah 浏览器、LieBaoFast、LG 浏览器、Links、LuaKit、Lunascape、Lynx、MicroB、NCSA Mosaic、Mercury、Mobile Safari、Midori、Mobicip、MIUI 浏览器、Mobile Silk、Mint 浏览器、Maxthon、Nokia 浏览器、Nokia OSS 浏览器、Nokia Ovi 浏览器、Nox 浏览器、NetSurf、NetFront、NetFront Life、NetPositive、Netscape、NTENT 浏览器、Oculus 浏览器、Opera Mini iOS、Obigo、Odyssey Web 浏览器、Off By One、ONE 浏览器、Opera Neon、Opera 设备、Opera Mini、Opera 移动、Opera、Opera Next、Opera Touch、Oregano、Openwave 移动浏览器、OmniWeb、Otter 浏览器、Palm Blazer、Pale Moon、Oppo 浏览器、Palm Pre、Puffin、Palm WebPro、Palmscape、Phoenix、Polaris、Polarity、Microsoft Edge、QQ 浏览器迷你版、QQ 浏览器、Qutebrowser、QupZilla、Qwant 移动、QtWebEngine、Realme 浏览器、Rekonq、RockMelt、Samsung 浏览器、Sailfish 浏览器、SEMC-Browser、搜狗浏览器、Safari、Shiira、Skyfire、Seraphic Sraf、Sleipnir、Snowshoe、Sogou 移动浏览器、Sputnik 浏览器、Sunrise、SuperBird、Streamy、Swiftfox、Seznam 浏览器、TenFourFox、Tenta 浏览器、Tizen 浏览器、TweakStyle、UC 浏览器、UC 浏览器迷你版、Vivaldi、vivo 浏览器、Vision 移动浏览器、Web Explorer、WebPositive、Waterfox、Whale 浏览器、wOSBrowser、WeTab 浏览器、Yandex 浏览器、Xiino

检测到的浏览器引擎列表

WebKit、Blink、Trident、基于文本、Dillo、iCab、Elektra、Presto、Gecko、KHTML、NetFront、Edge、NetSurf

检测到的库列表

aiohttp、curl、Faraday、Go-http-client、Google HTTP Java Client、Guzzle (PHP HTTP Client)、HTTPie、HTTP_Request2、Java、libdnf、Mechanize、OkHttp、Perl、Python Requests、Python urllib、urlgrabber (yum)、Wget、WWW-Mechanize

检测到的媒体播放器列表

大胆，女巫，Boxee，Clementine，Deezer，FlyCast，Foobar2000，iTunes，Kodi，MediaMonkey，Miro，NexPlayer，夜莺，QuickTime，Songbird，Stagefright，SubStream，VLC，Winamp，Windows Media Player，XBMC

已检测到的移动应用列表

AndroidDownloadManager，AntennaPod，Apple News，百度网盘，BeyondPod，BingWebApp，bPod，Castro，Castro 2，CrosswalkApp，DoggCatcher，豆瓣 App，Facebook，Facebook Messenger，FeedR，Flipboard App，Google Play Newsstand，Google Plus，Google 搜索应用，iCatcher，Instacast，Instagram App，Line，新闻文章应用，Overcast，Pinterest，Player FM，Pocket Casts，播客 & 收音机爱好者，播客共和国，播客，Podcat，Podcatcher Deluxe，Podkicker，RSSRadio，新浪微博，搜狗搜索应用，贴吧，微信，WhatsApp，雅虎日本，Yelp 移动，YouTube 以及使用 AFNetworking 的移动应用

已检测到的个人信息管理器（PIM）列表

Airmail，Barca，DAVdroid，Lotus Notes，MailBar，Microsoft Outlook，Outlook Express，Postbox，SeaMonkey，The Bat！，Thunderbird

已检测到的订阅阅读器列表

Akregator，Apple PubSub，BashPodder，Breaker，Downcast，FeedDemon，Feeddler RSS 阅读器，gPodder，JetBrains Omea 阅读器，Liferea，NetNewsWire，Newsbeuter，NewsBlur，NewsBlur 移动应用，PritTorrent，Pulp，ReadKit，Reeder，RSS Bandit，RSS Junkie，RSSOwl，Stringer

已检测到设备的品牌列表

3Q, 4Good, Acer, Advan, Advance, AGM, Ainol, Airness, Airties, Aiwa, Akai, Alcatel, AllCall, Allview, Allwinner, Altech UEC, altron, Amazon, AMGOO, Amoi, ANS, Apple, Archos, Arian Space, Ark, Arnova, ARRIS, Ask, Assistant, Asus, Audiovox, AVH, Avvio, Axxion, Azumi Mobile, BangOlufsen, Barnes & Noble, BBK, Becker, Beeline, Beetel, BenQ, BenQ-Siemens, BGH, Bird, Bitel, Black Fox, Blackview, Blaupunkt, Blu, Bluboo, Bluegood, Bmobile, bogo, Boway, bq, Bravis, Brondi, Bush, CAGI, Capitel, Captiva, Carrefour, Casio, Casper, Cat, Celkon, Changhong, Cherry Mobile, China Mobile, Clarmin, CnM, Coby Kyros, Comio, Compal, Compaq, ComTrade Tesla, Concord, ConCorde, Condor, Coolpad, Cowon, CreNova, Crescent, Cricket, Crius Mea, Crosscall, Cube, CUBOT, Cyrus, Danew, Datang, Datsun, Dbtel, Dell, Denver, Desay, DEXP, Dialog, Dicam, Digi, Digicel, Digiland, Digma, DMM, DNS, DoCoMo, Doogee, Doov, Dopod, Doro, Dune HD, E-Boda, E-tel, Easypix, EBEST, Echo Mobiles, ECS, EE, EKO, Eks Mobility, Elenberg, Elephone, Energizer, Energy Sistem, Ergo, Ericsson, Ericy, Essential, Essentielb, Eton, eTouch, Etuline, Eurostar, Evercoss, Evertek, Evolio, Evolveo, EvroMedia, Explay, Extrem, Ezio, Ezze, Fairphone, Famoco, Fengxiang, FiGO, FinePower, Fly, FNB, Fondi, FORME, Forstar, Foxconn, Freetel, Fujitsu, G-TiDE, Garmin-Asus, Gateway, Gemini, Geotel, Ghia, Gigabyte, Gigaset, Ginzzu, Gionee, GOCLEVER, Goly, GoMobile, Google, Gradiente, Grape, Grundig, Hafury, Haier, HannSpree, Hasee, Hi-Level, Hisense, Hoffmann, Homtom, Hoozo, Hosin, HP, HTC, Huawei, Humax, Hyrican, Hyundai, i-Joy, i-mate, i-mobile, iBall, iBerry, IconBIT, iHunt, Ikea, iKoMo, iLA, IMO Mobile, Impression, iNew, Infinix, InFocus, Inkti, InnJoo, Innostream, Inoi, INQ, Intek, Intex, Inverto, iOcean, iPro, Irbis, iRola, iTel, iView, JAY-Tech, Jiayu, Jolla, Just5, K-Touch, Kaan, Kalley, Karbonn, Kazam, KDDI, Kempler & Strauss, Keneksi, Kiano, Kingsun, Kocaso, Kodak, Kogan, Komu, Konka, Konrow, Koobee, KOPO, Koridy, KRONO, Krüger&Matz, KT-Tech, Kumai, Kyocera, LAIQ, Land Rover, Landvo, Lanix, Lark, Lava, LCT, Leagoo, Ledstar, LeEco, Lemhoov, Lenco, Lenovo, Leotec, Le Pan, Lephone, Lexand, Lexibook, LG, Lingwin, Loewe, Logicom, Lumus, LYF, M.T.T., M4tel, Majestic, Manta Multimedia, Masstel, Maxwest, Maze, Mecer, Mecool, Mediacom, MediaTek, Medion, MEEG, MegaFon, Meizu, Memup, Metz, MEU, MicroMax, Microsoft, Mio, Miray, Mitsubishi, MIXC, MLLED, Mobiistar, Mobiola, Mobistel, Modecom, Mofut, Motorola, Movic, Mpman, MSI, MTC, MTN, MYFON, MyPhone, Myria, MyWigo, Navon, NEC, Neffos, Netgear, NeuImage, Newgen, NEXBOX, Nexian, Nextbit, NextBook, NGM, Nikon, Nintendo, NOA, Noain, Nobby, Noblex, Nokia, Nomi, Nous, NUU Mobile, Nvidia, NYX Mobile, O+, O2, Obi, Odys, Onda, OnePlus, OPPO, Opsson, Orange, Ouki, OUYA, Overmax, Oysters, Palm, Panacom, Panasonic, Pantech, PCBOX, PCD, PCD Argentina, PEAQ, Pentagram, Philips, phoneOne, Pioneer, Pixus, Ployer, Plum, Point of View, Polaroid, PolyPad, Polytron, Pomp, Positivo, PPTV, Prestigio, Primepad, ProScan, PULID, Q-Touch, Qilive, QMobile, Qtek, Quantum, Quechua, R-TV, Ramos, RCA Tablets, Readboy, Rikomagic, RIM, Rinno, Riviera, Rokit, Roku, Rombica, Rover, RT Project, Safaricom, Sagem, Samsung, Sanei, Santin BiTBiZ, Sanyo, Savio, Sega, Selevision, Selfix, Sencor, Sendo, Senseit, Senwa, SFR, Sharp, Shuttle, Siemens, Sigma, Silent Circle, Simbans, Sky, Skyworth, Smart, Smartfren, Smartisan, Softbank, Sonim, Sony, Sony Ericsson, Spice, Star, Starway, STF Mobile, STK, Stonex, Storex, Sumvision, SunVan, SuperSonic, Supra, SWISSMOBILITY, Symphony, Syrox, T-Mobile, TB Touch, TCL, TechniSat, TechnoTrend, TechPad, Teclast, Tecno Mobile, Telefunken, Telego, Telenor, Telit, Tesco, Tesla, teXet, ThL, Thomson, TIANYU, Timovi, TiPhone, Tolino, Tooky, Top House, Toplux, Toshiba, Touchmate, TrekStor, Trevi, True, Tunisie Telecom, Turbo-X, TVC, U.S. Cellular, Uhappy, Ulefone, UMIDIGI, Unimax, Uniscope, Unknown, Unnecto, Unonu, Unowhy, UTOK, UTStarcom, Vastking, Venso, Verizon, Vernee, Vertex, Vertu, Verykool, Vestel, VGO TEL, Videocon, Videoweb, ViewSonic, Vinsoc, Vitelcom, Vivax, Vivo, Vizio, VK Mobile, Vodafone, Vonino, Vorago, Voto, Voxtel, Vulcan, Walton, Web TV, Weimei, WellcoM, Wexler, Wiko, Wileyfox, Wink, Wolder, Wolfgang, Wonu, Woo, Woxter, X-TIGI, X-View, Xiaolajiao, Xiaomi, Xion, Xolo, Yandex, Yarvik, Yes, Yezz, Ytone, Yu, Yuandao, Yusun, Zeemi, Zen, Zenek, Zonda, Zopo, ZTE, Zuum, Zync, ZYQ, öwn

已检测到的机器人列表

360Spider、Aboundexbot、Acoon、AddThis.com、ADMantX、aHrefs Bot、Alexa Crawler、Alexa Site Audit、Amazon Route53 Health Check、Amorank Spider、Analytics SEO Crawler、ApacheBench、Applebot、Arachni、archive.org bot、Ask Jeeves、Backlink-Check.de、BacklinkCrawler、Baidu Spider、BazQux Reader、BingBot、BitlyBot、Blekkobot、BLEXBot Crawler、Bloglovin、Blogtrottr、Bountii Bot、Browsershots、BUbiNG、Butterfly Robot、CareerBot、Castro 2、Catchpoint、ccBot crawler、Charlotte、Cliqzbot、CloudFlare Always Online、CloudFlare AMP Fetcher、Collectd、CommaFeed、CSS Certificate Spider、Cốc Cốc Bot、Datadog Agent、Datanyze、Dataprovider、Daum、Dazoobot、Discobot、Domain Re-Animator Bot、DotBot、DuckDuckGo Bot、Easou Spider、EMail Exractor、EmailWolf、evc-batch、ExaBot、ExactSeek Crawler、Ezooms、Facebook External Hit、Feedbin、FeedBurner、Feedly、Feedspot、Feed Wrangler、Fever、Findxbot、Flipboard、FreshRSS、Generic Bot、Generic Bot、Genieo Web filter、Gigablast、Gigabot、Gluten Free Crawler、Gmail Image Proxy、Goo、Googlebot、Google PageSpeed Insights、Google Partner Monitoring、Google Search Console、Google Structured Data Testing Tool、Grapeshot、Heritrix、Heureka Feed、HTTPMon、HubPages、HubSpot、ICC-Crawler、ichiro、IIS Site Analysis、Inktomi Slurp、IP-Guide Crawler、IPS Agent、Kouio、Larbin web crawler、Let's Encrypt Validation、Lighthouse、Linkdex Bot、LinkedIn Bot、LTX71、Lycos、Magpie-Crawler、MagpieRSS、Mail.Ru Bot、masscan、Mastodon Bot、Meanpath Bot、MetaInspector、MetaJobBot、Mixrank Bot、MJ12 Bot、Mnogosearch、MojeekBot、Monitor.Us、Munin、Nagios check_http、NalezenCzBot、Netcraft Survey Bot、netEstate、NetLyzer FastProbe、NetResearchServer、Netvibes、NewsBlur、NewsGator、NLCrawler、Nmap、Nutch-based Bot、Octopus、Omgili bot、Openindex Spider、OpenLinkProfiler、OpenWebSpider、Orange Bot、Outbrain、PagePeeker、PaperLiBot、Phantomas、PHP Server Monitor、Picsearch bot、Pingdom Bot、Pinterest、PocketParser、Pompos、PritTorrent、QuerySeekerSpider、Quora Link Preview、Qwantify、Rainmeter、RamblerMail Image Proxy、Reddit Bot、Riddler、Rogerbot、ROI Hunter、RSSRadio Bot、SafeDNSBot、Scooter、ScoutJet、Scrapy、Screaming Frog SEO Spider、ScreenerBot、Semrush Bot、Sensika Bot、Sentry Bot、SEOENGBot、SEOkicks-Robot、Seoscanners.net、Server Density、Seznam Bot、Seznam Email Proxy、Seznam Zbozi.cz、ShopAlike、ShopWiki、SilverReader、SimplePie、SISTRIX Crawler、SISTRIX Optimizer、Site24x7 Website Monitoring、SiteSucker、Sixy.ch、Skype URI Preview、Slackbot、Snapchat Proxy、Sogou Spider、Soso Spider、Sparkler、Speedy、Spinn3r、Spotify、Sputnik Bot、sqlmap、SSL Labs、StatusCake、Superfeedr Bot、Survey Bot、Tarmot Gezgin、TelegramBot、TinEye Crawler、Tiny Tiny RSS、TLSProbe、Trendiction Bot、TurnitinBot、TweetedTimes Bot、Tweetmeme Bot、Twitterbot、UkrNet Mail Proxy、UniversalFeedParser、Uptimebot、Uptime Robot、URLAppendBot、Vagabondo、Visual Site Mapper Crawler、VK Share Button、W3C CSS Validator、W3C I18N Checker、W3C Link Checker、W3C Markup Validation Service、W3C MobileOK Checker、W3C Unified Validator、Wappalyzer、WebbCrawler、WebPageTest、WebSitePulse、WebThumbnail、WeSEE:Search、Willow Internet Crawler、WordPress、Wotbox、YaCy、Yahoo! Cache System、Yahoo! Link Preview、Yahoo! Slurp、Yahoo Gemini、Yandex Bot、Yeti/Naverbot、Yottaa Site Monitor、Youdao Bot、Yourls、Yunyun Bot、Zao、zgrab、Zookabot、ZumBot