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 = FiftyOneDegreesTrieV3::provider_get();
my $match = $provider->getMatch($userAgent)
if ($match->getValue('IsMobile') == "True") { return TRUE; } else { return FALSE; }This example assumes you have the 51Degrees PHP API installed correctly, and have FiftyOneDegreesTrieV3.php in this directory.
require("../trie/FiftyOneDegreesTrieV3.php"); $provider = FiftyOneDegreesTrieV3::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"; }
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.