Přehled

Požadavky

  1. PHP 7.2.5
  2. Chcete-li používat obsluhu proudu PHP, musí být ve vašem systému allow_url_fopen povoleno. php.ini.
  3. Chcete-li použít obslužný program cURL, musíte mít nejnovější verzi cURL >= 7.19.4. zkompilovanou s OpenSSL a zlib.

Poznámka

Guzzle již nevyžaduje cURL k odesílání požadavků HTTP. Guzzle bude použije k odesílání požadavků HTTP obal PHP stream, pokud není nainstalován protokol cURL. Případně můžete poskytnout vlastní obslužný program HTTP používaný k odesílání požadavků. Mějte na paměti, že pro odesílání souběžných požadavků je cURL stále vyžadován.

Instalace

Doporučený způsob instalace aplikace Guzzle je pomocí nástroje Composer. Composer je nástroj pro správu závislostí pro PHP, který vám umožní deklarovat závislosti, které váš projekt potřebuje, a nainstaluje je do vašeho projektu.

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

Guzzle můžete přidat jako závislost pomocí nástroje Composer:

composer require guzzlehttp/guzzle:^7.0

Případně můžete Guzzle zadat jako závislost v existujícím souboru composer.json vašeho projektu:

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

Po instalaci je třeba vyžadovat autoloader aplikace Composer:

require 'vendor/autoload.php';

Více informací o instalaci Composeru, konfiguraci automatického spouštění a dalších osvědčených postupech pro definování závislostí najdete na getcomposer.org.

Bleeding edge

Během vývoje můžete držet krok s nejnovějšími změnami ve větvi master nastavením požadavku na verzi Guzzle na ^7.0@dev.

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

Licence

Licencováno pomocí licence MIT.

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

Tímto se uděluje bezplatné povolení každé osobě, která získá kopii. tohoto softwaru a souvisejících souborů dokumentace (dále jen "software"), aby nakládala s tímto softwarem a souvisejícími soubory dokumentace (dále jen "software"). se softwarem bez omezení, včetně, ale bez omezení, práv používat, kopírovat, upravovat, slučovat, publikovat, distribuovat, poskytovat sublicence a/nebo prodávat kopií softwaru, a povolit osobám, kterým je software k tomu oprávněny, za následujících podmínek:

Výše uvedené oznámení o autorských právech a toto oznámení o povolení musí být obsaženo ve všech kopiích nebo podstatných částech softwaru.

SOFTWARE JE POSKYTOVÁN "TAK, JAK JE", BEZ JAKÉKOLIV ZÁRUKY, VÝSLOVNÉ NEBO PŘEDPOKLÁDANÉ, VČETNĚ, ALE NEOMEZENÉ NA ZÁRUKY PRODEJNOSTI, VHODNOSTI PRO URČITÝ ÚČEL A NEPORUŠENÍ. V ŽÁDNÉM PŘÍPADĚ SE AUTOŘI NEBO DRŽITELÉ AUTORSKÝCH PRÁV NENESOU ODPOVĚDNOST ZA JAKÉKOLI NÁROKY, ŠKODY NEBO JINÉ ŠKODY. ODPOVĚDNOST, AŤ UŽ NA ZÁKLADĚ SMLOUVY, DELIKTU NEBO JINAK, VYPLÝVAJÍCÍ Z, ZE SOFTWARU NEBO V SOUVISLOSTI S NÍM NEBO S JEHO POUŽÍVÁNÍM ČI JINÝM JEDNÁNÍM S NÍM. SOFTWAREM.

Přispívání

Pokyny

  1. Guzzle používá PSR-1, PSR-2, PSR-4 a PSR-7.
  2. Guzzle má být štíhlý a rychlý s velmi malým počtem závislostí. To znamená, že že ne každý požadavek na funkci bude přijat.
  3. Guzzle má minimální požadavek na verzi PHP 7.2. Požadavky na stažení musí nesmí vyžadovat vyšší verzi PHP než PHP 7.2, pokud se nejedná o funkci, která je pouze používána podmíněně a soubor lze zpracovat pomocí PHP 7.2.
  4. Všechny žádosti o stažení musí obsahovat jednotkové testy, aby bylo zajištěno, že změna funguje tak, jak má. a aby se zabránilo regresím.

Provádění testů

Abyste mohli přispívat, musíte si stáhnout zdrojový kód z GitHubu a nainstalovat závislosti Guzzle pomocí nástroje Composer:

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

Guzzle je testován pomocí PHPUnit. Spusťte testy pomocí Makefile:

make test

Poznámka

K provedení integrace je třeba nainstalovat node.js v8 nebo novější verzi. testování HTTP obsluh Guzzle.

Nahlášení bezpečnostní chyby

Chceme zajistit, aby byl Guzzle bezpečnou klientskou knihovnou HTTP pro všechny. Pokud jste objevili bezpečnostní chybu v Guzzle, oceníme vaši pomoc. při jejím zveřejnění zodpovědným způsobem.

Zveřejnění zranitelnosti může ohrozit celou komunitu. Pokud jste objevili bezpečnostní problém, napište nám na adresu security@guzzlephp.org. Budeme s vámi spolupracovat, abychom se ujistili, že rozumíme. rozsahu problému a že plně vyřešíme vaše obavy. Zvážíme korespondenci zaslanou na adresu security@guzzlephp.org za naši nejvyšší prioritu a pracujeme na tom, abychom ji co nejrychleji řešit všechny vzniklé problémy.

Po opravě bezpečnostní chyby bude co nejdříve nasazena opravná verze zabezpečení.