Обзор и установка Guzzle

Требования к серверу

  1. PHP не ниже 5.5.0
  2. Чтобы использовать обработчик потока PHP, allow_url_fopen должен быть включен в php.ini.
  3. Чтобы использовать обработчик cURL, у вас должна быть последняя версия cURL >= 7.19.4, скомпилированная с OpenSSL и zlib.

Guzzle больше не требует cURL для отправки HTTP-запросов. Guzzle будет использовать потоковую оболочку PHP для отправки HTTP-запросов, если cURL не установлен. Кроме того, вы можете предоставить свой собственный обработчик HTTP, используемый для отправки запросов.

Установка

Рекомендуется устанавливать Guzzle с помощью Composer. Composer — это инструмент управления зависимостями для PHP, который позволяет вам объявлять зависимости, которые нужны вашему проекту, и устанавливать их в ваш проект.

С помощью консоли SSH устанавливаем Composer:

curl -sS https://getcomposer.org/installer | php

Теперь можно добавить Guzzle в качестве зависимости, используя composer.phar CLI:

php composer.phar require guzzlehttp/guzzle

Кроме того, вы можете указать Guzzle как зависимость в существующем файле вашего проекта composer.json:

 {
   "require": {
      "guzzlehttp/guzzle": "~7.0"
   }
}

После установки вам понадобится автозагрузчик Composer:

require 'vendor/autoload.php';

Вы можете узнать больше о том, как установить Composer, настроить автозагрузку и другие рекомендации по определению зависимостей в getcomposer.org

Версия для разработчиков

Во время разработки вы можете следить за последними изменениями в основной ветке, установив требование к версии для Guzzle в ~6.0@dev.

{
   "require": {
      "guzzlehttp/guzzle": "~7.0@dev"
   }
}

dev версия Guzzle может содержать ошибки, которые ещё не были обнаружены разработчиками. Для рабочих проектов рекомендуется использовать стабильную версию "guzzlehttp/guzzle": "~7.0"

Информация для контрибьюторов

Проект располагается на Github

Методические указания

  1. Guzzle использует PSR-1, PSR-2, PSR-4 и PSR-7.
  2. Guzzle проектировался с целью работать максимально быстро и иметь минимум зависимостей. Это означает, что далеко не каждый pull request с вашими правками будет принят.
  3. Guzzle работает на PHP версии 5.5 и выше. Поэтому любой функционал, который работает только на версии 5.6 и выше, будет отклонён.
  4. Все pull requests должны включать юнит-тесты, чтобы быть уверенным в качестве кода.

Запуск тестов

Чтобы внести свой вклад, вам нужно получить исходный код из GitHub и установить зависимости Guzzle с помощью Composer:

git clone https://github.com/guzzle/guzzle.git
cd guzzle && curl -s http://getcomposer.org/installer | php && ./composer.phar install --dev

Guzzle является модульным тестированием с PHPUnit. Запустите тесты, используя Makefile:

make test

Вам нужно установить node.js v0.5.0 или новее, чтобы выполнить интеграционные тесты на обработчиках HTTP Guzzle.

Сообщение об уязвимости в безопасности кода

Мы хотим, чтобы Guzzle была безопасной клиентской библиотекой HTTP для всех. Если вы обнаружили уязвимость безопасности в Guzzle, просьба помочь в раскрытии её ответственным образом.

Публичное раскрытие уязвимости может подвергнуть риску все сообщество. Если вы обнаружили проблему с безопасностью, напишите нам по адресу [email protected]. Мы будем работать с вами, чтобы убедиться, что мы понимаем суть проблемы и полностью решим вашу проблему. Мы считаем, что любая информация, отправленная на [email protected], является нашей первоочередной задачей и работаем над тем, чтобы как можно быстрее решить любые возникающие проблемы.

После исправления уязвимости системы безопасности исправление безопасности будет развернуто в кратчайшие сроки.

Смотрите далее: Примеры с Guzzle | Главная по Guzzle

Свежие записи

Свежие комментарии