Skip to content

Latest commit

 

History

History
154 lines (87 loc) · 3.1 KB

02-http-providers.md

File metadata and controls

154 lines (87 loc) · 3.1 KB

HTTP providers

A detailed description of all HTTP providers

General

Regardless of which HTTP provider you use, you need always a valid client to connect.

This library uses the GuzzleHttp library.

use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Handler\CurlHandler;

$handler = new CurlHandler();

$stack = HandlerStack::create($handler);

$client = new Client([
    'handler' => $stack,
    'timeout' => 3,

    'curl' => [
        // CURLOPT_SSL_VERIFYHOST => false,
        // CURLOPT_SSL_VERIFYPEER => false
    ]
]);

In all following examples, we assume that you defined the $client already and it's working.

Note about HTTP providers

The client can throw additional Exceptions like timeout/no connection/... if something is not working well.

Also the API provider can have have issues.

Be aware that it can fail, when you use HTTP providers

DeviceAtlasCom

Go to https://deviceatlas.com/ and get a valid API key.

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\DeviceAtlasCom($client, 'YOUR_API_KEY');

$result = $provider->parse($userAgent, $headers);

NeutrinoApiCom

Go to https://www.neutrinoapi.com/ and get a valid API key.

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\NeutrinoApiCom($client, 'YOUR_USER_ID', 'YOUR_API_KEY');

$result = $provider->parse($userAgent, $headers);

UdgerCom

Go to https://udger.com/ and get a valid API key.

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\UdgerCom($client, 'YOUR_API_KEY');

$result = $provider->parse($userAgent, $headers);

UserAgentApiCom

Go to https://useragentapi.com/ and get a valid API key.

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\UserAgentApiCom($client, 'YOUR_API_KEY');

$result = $provider->parse($userAgent, $headers);

UserAgentStringCom

Nothing to do, just use it

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\UserAgentStringCom($client);

$result = $provider->parse($userAgent, $headers);

WhatIsMyBrowserCom

Go to https://www.whatismybrowser.com/ and get a valid API key.

Use it

use UserAgentParser\Provider;

// @see $client definition in chapter "General"

$deviceAtlas = new Provider\Http\WhatIsMyBrowserCom($client, 'YOUR_API_KEY');

$result = $provider->parse($userAgent, $headers);