Преглед

Изисквания

  1. PHP 7.2.5
  2. За да използвате обработчика на потоци на PHP, allow_url_fopen трябва да е разрешен във вашия в php.ini на системата.
  3. За да използвате обслужващия модул cURL, трябва да разполагате с актуална версия на cURL >= 7.19.4 компилирана с OpenSSL и zlib.

Забележка

Guzzle вече не изисква cURL, за да изпраща HTTP заявки. Guzzle ще използва обвивката на PHP за изпращане на HTTP заявки, ако не е инсталиран cURL. Като алтернатива можете да предоставите свой собствен HTTP манипулатор, използван за изпращане на заявки. Имайте предвид, че cURL все още се изисква за изпращане на едновременни заявки.

Инсталиране

Препоръчителният начин за инсталиране на Guzzle е с Composer. Composer е инструмент за управление на зависимостите за PHP, който ви позволява да декларирате зависимостите, от които се нуждае вашият проект, и да и ги инсталира във вашия проект.

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

Можете да добавите Guzzle като зависимост с помощта на Composer:

composer require guzzlehttp/guzzle:^7.0

Като алтернатива можете да посочите Guzzle като зависимост в съществуващия файл composer.json на вашия проект:

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

След като инсталирате, трябва да изискате автозареждане на Composer:

require 'vendor/autoload.php';

Можете да научите повече за това как да инсталирате Composer, да конфигурирате автоматичното зареждане и други най-добри практики за дефиниране на зависимости в getcomposer.org.

Краят на кървенето

По време на разработката можете да сте в крак с последните промени в главния клон, като зададете изискването за версия за Guzzle на ^7.0@dev.

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

Лиценз

Лицензиран е с MIT лиценз.

Copyright (c) 2015 Michael Dowling <https://github.com/mtdowling>

С настоящото се предоставя безплатно разрешение на всяко лице, което получи копие на този софтуер и свързаните с него файлове с документация ("Софтуерът"), да работи със Софтуера без ограничения, включително без ограничение на правата да използват, копират, модифицират, обединяват, публикуват, разпространяват, сублицензират и/или продават копия на Софтуера, както и да разрешава на лицата, на които Софтуерът е да правят това, при следните условия:

Горното известие за авторски права и това известие за разрешение трябва да бъдат включени във всички копия или значителни части от софтуера.

СОФТУЕРЪТ СЕ ПРЕДОСТАВЯ "ТАКЪВ, КАКЪВТО Е", БЕЗ КАКВАТО И ДА Е ГАРАНЦИЯ, ИЗРИЧНА ИЛИ ПОДРАЗБИРАЩИ СЕ, ВКЛЮЧИТЕЛНО, НО НЕ САМО, ГАРАНЦИИ ЗА ПРОДАВАЕМОСТ, ГОДНОСТ ЗА ОПРЕДЕЛЕНА ЦЕЛ И НЕНАРУШАВАНЕ НА ПРАВА. В НИКАКЪВ СЛУЧАЙ АВТОРИТЕ ИЛИ ПРИТЕЖАТЕЛИТЕ НА АВТОРСКИ ПРАВА НЕ НОСЯТ ОТГОВОРНОСТ ЗА КАКВИТО И ДА БИЛО ИСКОВЕ, ЩЕТИ ИЛИ ДРУГИ ОТГОВОРНОСТ, НЕЗАВИСИМО ДАЛИ СТАВА ВЪПРОС ЗА ДЕЙСТВИЕ ПО ДОГОВОР, НЕПОЗВОЛЕНО УВРЕЖДАНЕ ИЛИ ПО ДРУГ НАЧИН, ПРОИЗТИЧАЩИ ОТ, ОТ ИЛИ ВЪВ ВРЪЗКА СЪС СОФТУЕРА ИЛИ ИЗПОЛЗВАНЕТО ИЛИ ДРУГИ ДЕЙСТВИЯ, СВЪРЗАНИ С СОФТУЕРА.

Принос

Насоки

  1. Guzzle използва PSR-1, PSR-2, PSR-4 и PSR-7.
  2. Guzzle трябва да бъде икономичен и бърз, с много малко зависимости. Това означава, че че не всяка заявка за функция ще бъде приета.
  3. Guzzle има изискване за минимална версия на PHP 7.2. Заявките за изтегляне трябва да не трябва да изискват версия на PHP, по-висока от PHP 7.2, освен ако функцията не е само се използва условно и файлът може да бъде обработен от PHP 7.2.
  4. Всички заявки за изтегляне трябва да включват тестове на модула, за да се гарантира, че промяната работи както и да се предотвратят регресии.

Извършване на тестовете

За да дадете своя принос, трябва да изтеглите изходния код от GitHub и да инсталирате зависимостите на Guzzle с помощта на Composer:

git clone https://github.com/guzzle/guzzle.git
cd guzzle && composer install

Guzzle се тества с PHPUnit. Изпълнете тестовете с помощта на Makefile:

make test

Забележка

За да извършите интеграцията, трябва да инсталирате node.js v8 или по-нова версия. тестове на HTTP манипулаторите на Guzzle.

Докладване на уязвимост в сигурността

Искаме да гарантираме, че Guzzle е сигурна клиентска библиотека за HTTP за всички. Ако сте открили уязвимост в сигурността на Guzzle, ще ви бъдем благодарни за помощта в разкриването ѝ пред нас по отговорен начин.

Публичното разкриване на уязвимост може да изложи на риск цялата общност. Ако сте открили проблем със сигурността, моля, изпратете ни имейл на адрес security@guzzlephp.org. Ще работим с вас, за да сме сигурни, че разбираме обхвата на проблема и че ще отговорим изцяло на притесненията ви. Ние разглеждаме кореспонденцията, изпратена до security@guzzlephp.org, за наш най-висок приоритет и работим, за да да се справяме с всички възникнали проблеми възможно най-бързо.

След като уязвимостта в сигурността бъде отстранена, в най-кратък срок ще бъде пусната гореща поправка на сигурността.