Освободиться от Guzzle5 с помощью PHP-HTTP и HTTPlug

Поскольку экземпляр HttpMethodsClient мы реализовали ранее, имеет метод get , никаких изменений в этом отношении не требуется. Однако экземпляр $response показывает несоответствие и на то есть веские причины. Исходный $response ожидаемый EntityFactory — это Guzzle5 Response.

Из-за того, что EntityFactory , нам на самом деле не нужно редактировать абстрактный API — он позаботится обо всем самостоятельно. Crawl call класса Crawl немного отличается:

 public function call ( ) { $response = $this - > diffbot - > getHttpClient ( ) - > get ( $this - > buildUrl ( ) ) ; $array = $response - > json ( ) ; if ( isset ( $array [ 'jobs' ] ) ) { $jobs = [ ] ; foreach ( $array [ 'jobs' ] as $job ) { $jobs [ ] = new JobCrawl ( $job ) ; } return new EntityIterator ( $jobs , $response ) ; } elseif ( ! isset ( $array [ 'jobs' ] ) && isset ( $array [ 'response' ] ) ) { return $array [ 'response' ] ; } else { throw new DiffbotException ( 'It appears something went wrong.' ) ; } } 

Здесь два предупреждения — вторая строка метода, использующего метод json $response , и экземпляр EntityIterator который ожидает ответ Guzzle5. Единственная строка, на которую мы можем повлиять, это первая, поэтому давайте изменим ее на:

 $array = json_decode($response->getBody(), true); 

Аналогичное изменение необходимо сделать в методе call класса Search , где строка:

 $arr = $ei->getResponse()->json(['big_int_strings' => true]); 

меняется на:

 $arr = json_decode((string)$ei->getResponse()->getBody(), true, 512, 1); 

Entity Factory

Класс EntityFactory имеет следующий импорт в верхней части:

 use GuzzleHttp\Message\ResponseInterface as Response; 

Мы можем изменить это на:

 use Psr\Http\Message\ResponseInterface as Response; 

То же самое необходимо сделать в интерфейсе EntityFactory который EntityFactory класс EntityFactory .

Другое изменение аналогично тому, что мы сделали выше, в классе Crawl . Мы меняемся:

 $arr = $response->json(['big_int_strings' => true]); 

в

 $arr = json_decode($response->getBody(), true, 512, 1); 

как в checkResponseFormat и в методах createAppropriateIterator .

Entity Iterator

Мы меняемся:

 use GuzzleHttp\Message\ResponseInterface as Response; 

в

 use Psr\Http\Message\ResponseInterface as Response; 

тесты

Mocking, основной способ тестирования HTTP-запросов и вызовов API, отличается в Guzzle 6 , поэтому наши тесты нуждаются в немного большем пересмотре.

Поскольку этот урок уже немного длинен, просмотрите соответствующую ветку функций, если вы заинтересованы в изучении различий в насмешках между Guzzle 5 и Guzzle 6 и, в частности, между двумя версиями Diffbot SDK.

Наконец, давайте запустим тесты:

 phpunit PHPUnit 5.0.8 by Sebastian Bergmann and contributors. Runtime: PHP 5.6.10-1+deb.sury.org~trusty+1 with Xdebug 2.3.2 Configuration: /home/vagrant/Code/diffbot-php-client/phpunit.xml.dist ............................................................... 63 / 347 ( 18%) ............................................................... 126 / 347 ( 36%) ............S.................................................. 189 / 347 ( 54%) ............................................................... 252 / 347 ( 72%) ............................................................... 315 / 347 ( 90%) ................................ 347 / 347 (100%) Time: 55.78 seconds, Memory: 34.25Mb 

Успех! Все прохождения (кроме ожидаемого пропущенного теста).

Diffbot SDK теперь не только совместим с PSR-7, но и восприимчив к другим реализациям HTTP-клиентов. Все, что ему нужно, это адаптер, поддерживающий интерфейс HTTPlug, и все должно работать «из коробки».

Вывод

HTTPlug — это новый полезный подход для абстрагирования реализаций HTTP-клиентов в создаваемых нами приложениях. Будь мы сами создаем HTTP-клиенты или используем их в других приложениях, PHP-HTTP предоставляет совершенно новый мир расширяемости за разумную цену за один дополнительный уровень абстракции.

Если вы хотите помочь, добавив больше реализаций адаптера или просто опробовав пакеты и предоставив обратную связь, команда приветствует все предложения. Свяжитесь с нами или оставьте свой отзыв в разделе комментариев ниже, и если вы нашли этот урок интересным, не забудьте нажать кнопку «Нравится»!