Prehľad

Požiadavky

  1. PHP 7.2.5
  2. Ak chcete používať obsluhu prúdu PHP, allow_url_fopen musí byť vo vašom php.ini.
  3. Ak chcete používať obsluhu cURL, musíte mať najnovšiu verziu cURL >= 7.19.4 skompilovanú s OpenSSL a zlib.

Poznámka

Guzzle už nevyžaduje cURL na odosielanie požiadaviek HTTP. Guzzle bude použije na odosielanie požiadaviek HTTP obálku PHP stream wrapper, ak nie je nainštalovaný cURL. Prípadne môžete poskytnúť vlastný obslužný program HTTP, ktorý sa používa na odosielanie požiadaviek. Majte na pamäti, že cURL sa stále vyžaduje na odosielanie súbežných požiadaviek.

Inštalácia

Odporúčaný spôsob inštalácie aplikácie Guzzle je pomocou Composer. Composer je nástroj na správu závislostí pre PHP, ktorý vám umožňuje deklarovať závislosti, ktoré váš projekt potrebuje, a nainštaluje ich do vášho projektu.

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

Aplikáciu Guzzle môžete pridať ako závislosť pomocou nástroja Composer:

composer require guzzlehttp/guzzle:^7.0

Prípadne môžete zadať Guzzle ako závislosť v existujúcom súbore composer.json vášho projektu:

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

Po inštalácii musíte vyžadovať autoloader programu Composer:

require 'vendor/autoload.php';

Viac informácií o tom, ako nainštalovať Composer, nakonfigurovať automatické načítanie a ďalšie osvedčené postupy definovania závislostí nájdete na getcomposer.org.

Bleeding edge

Počas vývoja môžete držať krok s najnovšími zmenami vo vetve master nastavením požiadavky na verziu pre Guzzle na ^7.0@dev.

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

Licencia

Licencované pomocou MIT licencie.

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

Týmto sa udeľuje bezplatné povolenie každej osobe, ktorá získa kópiu tohto softvéru a súvisiacich dokumentačných súborov (ďalej len "softvér"), na nakladanie so softvérom bez obmedzenia, vrátane bez obmedzenia práv používať, kopírovať, upravovať, spájať, publikovať, distribuovať, sublicencovať a/alebo predávať kópií softvéru a povoliť osobám, ktorým je softvér aby tak urobili, za nasledujúcich podmienok:

Vyššie uvedené upozornenie o autorských právach a toto upozornenie o povolení budú zahrnuté vo všetkých kópiách alebo podstatných častiach softvéru.

SOFTVÉR SA POSKYTUJE "TAK, AKO JE", BEZ AKEJKOĽVEK ZÁRUKY, VÝSLOVNEJ ALEBO VRÁTANE, ALE NIE VÝLUČNE, ZÁRUK PREDAJNOSTI, VHODNOSTI NA KONKRÉTNY ÚČEL A NEPORUŠENIA. V ŽIADNOM PRÍPADE SA AUTORI ALEBO DRŽITELIA AUTORSKÝCH PRÁV NEZODPOVEDAJÚ ZA ŽIADNE NÁROKY, ŠKODY ALEBO INÉ ZODPOVEDNOSŤ, ČI UŽ V RÁMCI ZMLUVNÉHO, DELIKTNÉHO ALEBO INÉHO KONANIA, VYPLÝVAJÚCU Z, ZO SOFTVÉRU ALEBO V SÚVISLOSTI S NÍM ALEBO S JEHO POUŽÍVANÍM ALEBO INÝM ZAOBCHÁDZANÍM S NÍM SOFTVÉROM.

Prispievanie

Usmernenia

  1. Guzzle používa PSR-1, PSR-2, PSR-4 a PSR-7.
  2. Guzzle má byť štíhly a rýchly s veľmi malým počtom závislostí. To znamená, že že nie každá požiadavka na funkciu bude prijatá.
  3. Guzzle má minimálnu požiadavku na verziu PHP 7.2. Žiadosti o stiahnutie musia nesmú vyžadovať verziu PHP vyššiu ako PHP 7.2, pokiaľ funkcia nie je len použitá len podmienečne a súbor môže byť analyzovaný PHP 7.2.
  4. Všetky žiadosti o stiahnutie musia obsahovať jednotkové testy, aby sa zabezpečilo, že zmena funguje tak, ako má. a aby sa zabránilo regresiám.

Spustenie testov

Ak chcete prispieť, musíte si stiahnuť zdrojový kód z GitHubu a nainštalovať závislosti Guzzle pomocou nástroja Composer:

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

Guzzle je testovaný pomocou PHPUnit. Spustite testy pomocou súboru Makefile:

make test

Poznámka

Na vykonanie integrácie je potrebné nainštalovať node.js v8 alebo novšiu verziu testovanie obslužných programov HTTP aplikácie Guzzle.

Nahlásenie bezpečnostnej zraniteľnosti

Chceme zabezpečiť, aby bola knižnica Guzzle bezpečným klientom HTTP pre každého. Ak ste objavili bezpečnostnú chybu v Guzzle, oceníme vašu pomoc pri jej zverejnení zodpovedným spôsobom.

Verejné odhalenie zraniteľnosti môže ohroziť celú komunitu. Ak ste objavili bezpečnostný problém, pošlite nám e-mail na adresu security@guzzlephp.org. Budeme s vami spolupracovať, aby sme sa uistili, že sme pochopili rozsah problému a že plne riešime vaše obavy. Zohľadňujeme korešpondenciu zaslanú na adresu security@guzzlephp.org za našu najvyššiu prioritu a pracujeme na čo najrýchlejšie riešiť všetky vzniknuté problémy.

Po odstránení bezpečnostnej chyby bude čo najskôr nasadená opravná bezpečnostná verzia.