PHP Strongly Typed Tutorial

On-Premise

PREMIUM

ENTERPRISE

BESPOKE

Price

$499 / YEAR

$999 / YEAR

POA

No. of Combinations

> 940,000

> 1,190,000

No. of Properties

> 140

> 220

No. of Detections

Unlimited

No. of Websites

Unlimited

Updates

Weekly

Daily

Support

Forum Support

SLA

Unlimited Servers

Yes

Unlimited Analytics

Yes

TRIAL BUY

QUOTE

Cloud

LITE

PREMIUM

Price

FREE

$25 / Month

No. of Combinations

> 365,000

> 940,000

No. of Properties

> 65

> 140

No. of Values

With > 2,860

With > 210,000

No. of Data Centres

5 Global Data Centres

No. of Websites

Unlimited

Detections Per Minute

100

1,000

Support

Forum Support

BUY

What's Covered

51Degrees device detector returns all detection results as a string. This tutorial demonstrates how to return results for the IsMobile property value as a boolean.

Code and Explanation

Getting started example of using 51Degrees device detection. The example shows how to:

Fetch a pointer to the 51Degrees device detection provider instance. This is instantiated on server startup and uses settings from php.ini.
```
$provider = FiftyOneDegreesPatternV3::provider_get();
```
Produce a match for a single HTTP User-Agent header
```
my $match = $provider->getMatch($userAgent)
```

Extract the value of the IsMobile property as a boolean

if ($match->getValue('IsMobile') == "True") {
	return TRUE;
}
else {
	return FALSE;
}

This example assumes you have the 51Degrees PHP API installed correctly, and have FiftyOneDegreesPatternV3.php in this directory.

Full Source File

require("../pattern/FiftyOneDegreesPatternV3.php");

$provider = FiftyOneDegreesPatternV3::provider_get();

// User-Agent string of an iPhone mobile device.
$mobileUserAgent = "Mozilla/5.0 (iPhone; CPU iPhone OS 7_1 like Mac OS X) ".
"AppleWebKit/537.51.2 (KHTML, like Gecko) 'Version/7.0 Mobile/11D167 ".
"Safari/9537.53";

// User-Agent string of Firefox Web browser version 41 on desktop.
$desktopUserAgent = "Mozilla/5.0 (Windows NT 6.3; WOW64; rv:41.0) ".
"Gecko/20100101 Firefox/41.0";

// User-Agent string of a MediaHub device.
$mediaHubUserAgent = "Mozilla/5.0 (Linux; Android 4.4.2; X7 Quad Core ".
"Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 ".
"Chrome/30.0.0.0 Safari/537.36";


// isMobile function. Takes a match object as an argument, carries out a
// match and returns a boolean value for the IsMobile property of the
// matched device.

function isMobile($match) {
    if ($match->getValue("IsMobile") == "True") {
        return TRUE;
    }
    else {
        return FALSE;
    }
}

echo "Starting Getting Started Strongly Typed Example.<br>\n";

// Determines whether the mobile User-Agent is a mobile device.
echo "<br>\nMobile User-Agent: ".$mobileUserAgent."<br>\n";
$match = $provider->getMatch($mobileUserAgent);
$isMobileBool = isMobile($match);
if ($isMobileBool) {
    echo "Mobile<br>\n";
}
else {
    echo "Non-Mobile<br>\n";
}

// Determines whether the desktop User-Agent is a mobile device.
echo "<br>\nDesktop User-Agent: ".$desktopUserAgent."<br>\n";
$match = $provider->getMatch($desktopUserAgent);
$isMobileBool = isMobile($match);
if ($isMobileBool) {
    echo "Mobile<br>\n";
}
else {
    echo "Non-Mobile<br>\n";
}

// Determines whether the MediaHub User-Agent is a mobile device.
echo "<br>\nMediaHub User-Agent: ".$mediaHubUserAgent."<br>\n";
$match = $provider->getMatch($mediaHubUserAgent);
$isMobileBool = isMobile($match);
if ($isMobileBool) {
    echo "Mobile<br>\n";
}
else {
    echo "Non-Mobile<br>\n";
}

Full Source File

Summary

In this tutorial you have seen how to use the detector to retrieve the IsMobile property for a pre-defined User-Agent string. It sets a boolean value to true or false from the original string value of "True" or "False", making if statements simpler to test.

Device Detection

Enhanced Analytics

Performance Monitoring

On-Premise

Cloud

Legal T&Cs

Adtech

Brands

Publishers

E-commerce

Digital Agencies

CMS

Read Case Studies

Compatible Web Platforms

Developer Documentation

Enhanced Data

APIs

Property Dictionary

User Agent Tester

Developer Blogs

Forum

Store

FAQs

Device Explorer

Competitor Comparison

Images

Mobile Emulators

PHP API

What's Covered

Code and Explanation

Summary

More Tutorials

	51Degrees	DeviceAtlas	ScientiaMobile WURFL^TM
>1,180,000 Device Combinations
0.0009ms Average Detection Time
> 99.9% Accuracy
Slow Regular Expressions
Confidence Indicators (false positives)