File Provider/WebProvider.php | ICanBoogie/CLDR 2.0.x

  1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115

<?php

/*
 * This file is part of the ICanBoogie package.
 *
 * (c) Olivier Laviale <olivier.laviale@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace ICanBoogie\CLDR\Provider;

use ICanBoogie\CLDR\Provider;
use ICanBoogie\CLDR\ResourceNotFound;
use ICanBoogie\CLDR\Provider\WebProvider\PathMapper;

/**
 * Retrieves sections from the CLDR source using cURL.
 */
class WebProvider implements Provider
{
    /**
     * @var resource
     */
    private $connection;

    /**
     * @var PathMapper
     */
    private $mapper;

    /**
     * @param string $origin
     * @param string $version
     * @param string $variation
     */
    public function __construct(
        $origin = PathMapper::DEFAULT_ORIGIN,
        $version = PathMapper::DEFAULT_VERSION,
        $variation = PathMapper::DEFAULT_VARIATION
    ) {
        $this->mapper = new PathMapper($origin, $version, $variation);
    }

    /**
     * The section path, following the pattern "<identity>/<section>".
     *
     * @param string $key
     *
     * @return string
     *
     * @throws ResourceNotFound when the specified path does not exists on the CLDR source.
     */
    public function provide($key)
    {
        $connection = $this->obtain_connection();
        $url = $this->map($key);

        curl_setopt($connection, CURLOPT_URL, $url);

        $rc = curl_exec($connection);

        $http_code = curl_getinfo($connection, CURLINFO_HTTP_CODE);

        if ($http_code != 200)
        {
            throw new ResourceNotFound($key);
        }

        return json_decode($rc, true);
    }

    /**
     * Returns a reusable cURL connection.
     *
     * @return resource
     */
    private function obtain_connection()
    {
        $connection = &$this->connection;

        return $connection ?: $connection = $this->create_connection();
    }

    /**
     * @return resource
     */
    private function create_connection()
    {
        $connection = curl_init();

        curl_setopt_array($connection, [

            CURLOPT_FAILONERROR => true,
            CURLOPT_RETURNTRANSFER => true

        ]);

        return $connection;
    }

    /**
     * Map a CLDR path to a distribution URL.
     *
     * @param string $path
     *
     * @return string
     */
    private function map($path)
    {
        return $this->mapper->map($path);
    }
}

Namespaces

Classes