- Prerequisites
- Premium Data
- Getting Started
- Summary
- Distributions
- 51Degrees.php Config
- Using the Detector
- Advanced Usage
- Accessing Metadata
- Image Optimiser
- Client Side Overrides
- Passing Properties To Client Side
- User Performance Monitoring
- Usage Sharing
- Automatic Data Updates
- Advanced Suggestions
- Troubleshooting
Usage - version 3.2
Function fiftyone_match()
Description
You can use the user agent HTTP header to get device properties by calling the fiftyone_match function.
Parameters
Function takes in a user agent string, typically derived from the PHP $_SERVER.
Returns
Function returns an array of property:value pairs for each of the properties available in your data file, or NULL if there was a problem.
Example:
<?php $properties = fiftyone_match( $_SERVER [ 'HTTP_USER_AGENT' ]); ?>
Function fiftyone_match_with_headers()
Description
Some browsers provide additional HTTP headers that can improve detection accuracy. You can now call a function that takes in a string of header : value pairs where the headers are separated by the new line. The API will automatically find the relevant HTTP headers and perform detection.
Parameters
Function takes in a string of HTTP header name : header value pairs where the header name is separated from the header value by a space or a colon. Entries must be separated by the new line '\n'.
Returns
Function returns an array of property:value pairs for each of the properties available in your data file, or NULL if there was a problem.
Example:
<?php $headers ; foreach ( $_SERVER as $key => $value ) { if ( strpos ( $key , "HTTP_" ) !== false ) { $headers = $headers . $key . " " . $value . " \n " ; } } $result = fiftyone_match_with_headers( $headers ); ?>
Function fiftyone_info()
Description
Displays information about the data file currently used by the device detection C extension module.
Parameters
No input required.
Returns
Prints a block of HTML with information about the data file used.
Example:
<?php fiftyone_info(); ?>
Usage - version 3.1
Device Properties
Device properties can be fetched with the fiftyone_degrees_get_properties function:
$p = fiftyone_degrees_get_properties($_SERVER['HTTP_USER_AGENT']); echo "Total properties in array: ".sizeof($p); echo "<pre>"; var_dump($p); echo "</pre>";
The function takes user agent string as a parameter and returns an array of properties and their values, like the $_51d variable in the pure PHP API. The above snippet produces the following result using the Lite data file:
Points to Note
The 51 Degrees data file needs to be refreshed on a regular basis in order to keep it current. This is best achieved by running a CRON job on the Linux server. Additionally, a PHP script can be used to obtain meta data information. By default all property values are returned as strings.