rvasiliy/http_client

Http client library

Tuesday, April 24, 2018
by rvasiliy
Repository
1 Watchers
0 Stars
15 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
8 Versions
7 % Grown

The README.md

HttpClient

, _(*1)

Описание

HttpClient - библиотека для создания систем для отправки и получения запросов посредством http протокола. Например REST сервисов., _(*2)

Зависимости

PHP: версия 5.6 и выше

Установка

    composer require rvasiliy/http_client

или, _(*3)

    // composer.json

    "require": {
        "rvasiliy/http_client": "*"
    }

Конфигурация

Для работы клиент может быть сконфигурирован посредством массива конфигурации. Конфигурация по умолчанию выглядит следующим образом:, _(*4)

    $config = [
        // базовый url, который будет добавлен как префикс к другим
        'baseUrl' => '',

        'serializer' => [
            'class' => 'rvasiliy\\http_client\\serializer\\StringSerializer',
        ],
    ];

Если требуется обрабатывать ответы в формате json, то конфигурация должна быть такой:, _(*5)

    $config = [
        // базовый url, который будет добавлен как префикс к другим
        'baseUrl' => '',

        'serializer' => [
            'class' => 'rvasiliy\\http_client\\serializer\\JsonSerializer',
            'property' => [
                // true - данные в виде массива
                // false - данные в виде объекта
                'asArray' => true,
            ],
        ],
    ];

Создание и конфигурация клиента

    require __DIR__ . '/vendor/autoload.php';

    \rvasiliy\http_client\HttpClient::configure($config);
    $client = \rvasiliy\http_client\HttpClient::getInstance();

или, _(*6)

    require __DIR__ . '/vendor/autoload.php';

    $client = \rvasiliy\http_client\HttpClient::getInstance();
    $client->setConfig($config);

Получить доступ к объекту конфигурации можно так:, _(*7)

    $config = \rvasiliy\http_client\HttpClient::getInstance()->getConfig();

Это можно использовать для получения доступа к переменным конфигурации по всему приложению., _(*8)

С версии 2.0.0 если конфигурация не была применена, то будет создана конфигурация по умолчанию. Найти ее можно в файле config/default.php., _(*9)

Отправка запросов

    // создаем объект запроса
    $request = new \rvasiliy\http_client\Request();
    $request->setUrl('http://example.com/status');
    $request->setParams(['name' => 'Jon']);

    // отправляем запрос и получаем ответ
    $response = $client->send($request);

С версии 1.1.0 объект запроса можно передавать в клиент с помощью сеттера., _(*10)

    // создаем объект запроса
    $request = new \rvasiliy\http_client\Request();
    $request->setUrl('http://example.com/status');
    $request->setParams(['name' => 'Jon']);

    // передаем запрос в клиент
    $client->setRequest($request);

    // отправляем запрос и получаем ответ
    $response = $client->send();

Получение данных

Когда объект ответа получен, из него можно получить данные., _(*11)

    $data = $response->getData();

Формат получаемых данных зависит от используемого сериализатора в объекте ответа., _(*12)

StringSerializer - данные не изменяются и возвращаются в таком же виде, в котором они були получены с сервера;, _(*13)
JsonSerializer - преобразует данные в массив или объект в зависимости от настроек;, _(*14)
Вы также можете создавать свои сериализаторы, реализуя интерфейс rvasiliy\http_client\Serializer., _(*15)

Доступ к объекту сериализатора возможен через объект ответа:, _(*16)

    $serializer = $response->getSerializer();

Пример кода. Все вместе

    // подключаем автозагрузчик классов
    require __DIR__ . '/vendor/autoload.php';

    // массив конфигурации
    $config = [
        'baseUrl' => 'http://example.com',
        'serializer' => [
            'class' => 'rvasiliy\\http_client\\serializer\\JsonSerializer',
            'property' => [
                'asArray' => false,
            ],
        ],
    ];

    // создаем и конфигурируем клиент
    $client = \rvasiliy\http_client\HttpClient::getInstance();
    $client->setConfig($config);

    // создаем объект запроса
    $request = new \rvasiliy\http_client\Request();
    $request->setUrl('/status');
    $request->setParams(['name' => 'Jon']);

    // отправляем запрос
    $response = $client->send($request);

    // получаем данные
    $data = $response->getData();

The Versions

24/04 2018

dev-master

9999999-dev https://github.com/rvasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

24/04 2018

dev-dev

dev-dev https://github.com/rvasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

24/04 2018

v2.0.1

2.0.1.0 https://github.com/rvasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

07/04 2018

v2.0.0

2.0.0.0 https://github.com/rvasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

31/03 2018

v1.1.1

1.1.1.0 https://github.com/rvasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

25/03 2018

v1.1.0

1.1.0.0 https://github.com/RVasiliy/http_client

Http client library

Sources Download

MIT

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

http client

24/03 2018

v1.0.0.1

1.0.0.1

Http client library

Sources Download

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

by rvasiliy

22/03 2018

v1.0.0

1.0.0.0

Http client library

Sources Download

The Requires

php >=5.6.0

The Development Requires

phpunit/phpunit ^5

library http_client

Http client library

rvasiliy/http_client

The README.md

HttpClient

Описание

Зависимости

Установка

Конфигурация

Создание и конфигурация клиента

Отправка запросов

Получение данных

Пример кода. Все вместе

The Versions

dev-master

The Requires

The Development Requires

by rvasiliy

dev-dev

The Requires

The Development Requires

by rvasiliy

v2.0.1

The Requires

The Development Requires

by rvasiliy

v2.0.0

The Requires

The Development Requires

by rvasiliy

v1.1.1

The Requires

The Development Requires

by rvasiliy

v1.1.0

The Requires

The Development Requires

by rvasiliy

v1.0.0.1

The Requires

The Development Requires

by rvasiliy

v1.0.0

The Requires

The Development Requires

by rvasiliy