1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
<?php
/**
* Device Detector - The Universal Device Detection library for parsing User Agents
*
* @link https://matomo.org
*
* @license http://www.gnu.org/licenses/lgpl.html LGPL v3 or later
*/
declare(strict_types=1);
namespace DeviceDetector\Parser\Client;
use DeviceDetector\Cache\CacheInterface;
use DeviceDetector\ClientHints;
use DeviceDetector\Parser\Client\Hints\AppHints;
use DeviceDetector\Yaml\ParserInterface as YamlParser;
/**
* Class MobileApp
*
* Client parser for mobile app detection
*/
class MobileApp extends AbstractClientParser
{
/**
* @var AppHints
*/
private $appHints;
/**
* @var string
*/
protected $fixtureFile = 'regexes/client/mobile_apps.yml';
/**
* @var string
*/
protected $parserName = 'mobile app';
/**
* MobileApp constructor.
*
* @param string $ua
* @param ClientHints|null $clientHints
*/
public function __construct(string $ua = '', ?ClientHints $clientHints = null)
{
$this->appHints = new AppHints($ua, $clientHints);
parent::__construct($ua, $clientHints);
}
/**
* Sets the client hints to parse
*
* @param ?ClientHints $clientHints client hints
*/
public function setClientHints(?ClientHints $clientHints): void
{
parent::setClientHints($clientHints);
$this->appHints->setClientHints($clientHints);
}
/**
* Sets the user agent to parse
*
* @param string $ua user agent
*/
public function setUserAgent(string $ua): void
{
parent::setUserAgent($ua);
$this->appHints->setUserAgent($ua);
}
/**
* Sets the Cache class
*
* @param CacheInterface $cache
*/
public function setCache(CacheInterface $cache): void
{
parent::setCache($cache);
$this->appHints->setCache($cache);
}
/**
* Sets the YamlParser class
*
* @param YamlParser $yamlParser
*/
public function setYamlParser(YamlParser $yamlParser): void
{
parent::setYamlParser($yamlParser);
$this->appHints->setYamlParser($this->getYamlParser());
}
/**
* Parses the current UA and checks whether it contains any client information
* See parent::parse() for more details.
*
* @return array|null
*/
public function parse(): ?array
{
$result = parent::parse();
$name = $result['name'] ?? '';
$version = $result['version'] ?? '';
$appHash = $this->appHints->parse();
if (null !== $appHash && $appHash['name'] !== $name) {
$name = $appHash['name'];
$version = '';
}
if (empty($name)) {
return null;
}
return [
'type' => $this->parserName,
'name' => $name,
'version' => $version,
];
}
}
|
