Check out the latest documentation.

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:

  1. 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.