Apžvalga¶

Reikalavimai¶

PHP 7.2.5
Kad galėtumėte naudoti PHP srauto tvarkyklę, allow_url_fopen turi būti įjungta jūsų php.ini.
Norėdami naudoti cURL tvarkyklę, turite turėti naujausią cURL versiją >= 7.19.4 sukompiliuotą su OpenSSL ir zlib.

Pastaba

"Guzzle" nebereikia cURL, kad būtų galima siųsti HTTP užklausas. Guzzle HTTP užklausoms siųsti naudos PHP srauto apvalkalą, jei cURL nėra įdiegtas. Arba galite pateikti savo HTTP tvarkyklę, naudojamą užklausoms siųsti. Nepamirškite, kad cURL vis dar reikalingas vienu metu siunčiamoms užklausoms siųsti.

Įrengimas¶

Rekomenduojamas "Guzzle" diegimo būdas yra Composer. Composer yra priklausomybių valdymo įrankis skirta PHP, kuri leidžia deklaruoti projektui reikalingas priklausomybes ir jas įdiegia į projektą.

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

Galite pridėti "Guzzle" kaip priklausomybę naudodami "Composer":

composer require guzzlehttp/guzzle:^7.0

Arba galite nurodyti "Guzzle" kaip priklausomybę savo projekto kompozitoriaus.json faile:

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

Įdiegus reikia reikalauti "Composer" automatinio paleidimo programos:

require 'vendor/autoload.php';

Daugiau informacijos apie tai, kaip įdiegti "Composer", sukonfigūruoti automatinį įkėlimą ir kitą geriausią priklausomybių nustatymo praktiką, galite rasti getcomposer.org.

Krintantis kraštas¶

Kurdami galite neatsilikti nuo naujausių pagrindinės šakos pakeitimų nustatę "Guzzle" versijos reikalavimą ^7.0@dev.

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

Licencija¶

Licencijuojama pagal MIT licenciją.

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

Šiuo leidimu nemokamai leidžiama bet kuriam asmeniui, gaunančiam kopiją šios programinės įrangos ir susijusių dokumentų failų (toliau - "Programinė įranga"). Programine įranga be jokių apribojimų, įskaitant, bet neapsiribojant teisėmis naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, sublicencijuoti ir (arba) parduoti Programinės įrangos kopijas ir leisti asmenims, kuriems Programinė įranga tai daryti, laikantis toliau nurodytų sąlygų:

Aukščiau pateiktas pranešimas apie autorių teises ir šis pranešimas apie leidimą turi būti įtrauktas į visas Programinės įrangos kopijas ar esmines jos dalis.

PROGRAMINĖ ĮRANGA TEIKIAMA "TOKIA, KOKIA YRA", BE JOKIŲ AIŠKIŲ AR TIESIOGINIŲ GARANTIJŲ. NUMANOMŲ, ĮSKAITANT, BET NEAPSIRIBOJANT, TINKAMUMO PARDUOTI GARANTIJOMIS, TINKAMUMO TAM TIKRAM TIKSLUI IR NEPAŽEIDIMO. JOKIAIS ATVEJAIS AUTORIAI AR AUTORIŲ TEISIŲ TURĖTOJAI NEATSAKO UŽ JOKIUS REIKALAVIMUS, ŽALĄ AR KITUS ATSAKOMYBĘ, KYLANČIĄ IŠ SUTARTIES, DELIKTO AR KITŲ PRIEŽASČIŲ, IŠ PROGRAMINĖS ĮRANGOS ARBA DĖL JOS NAUDOJIMO AR KITOKIO ELGESIO SU JA. PROGRAMINE ĮRANGA.

Prisidėjimas¶

Gairės¶

"Guzzle" naudoja PSR-1, PSR-2, PSR-4 ir PSR-7.
"Guzzle" turi būti taupi ir greita, turėti labai mažai priklausomybių. Tai reiškia, kad kad ne kiekvienas funkcijų prašymas bus priimtas.
"Guzzle" minimalus PHP versijos reikalavimas yra PHP 7.2. "Pull" užklausos turi reikalauti didesnės nei PHP 7.2 PHP versijos, išskyrus atvejus, kai funkcija yra tik naudojama tik sąlyginai ir failą galima analizuoti naudojant PHP 7.2.
Visos užklausos turi apimti vieneto testus, kad būtų užtikrinta, jog pakeitimas veikia taip, kaip ir užkirsti kelią regresijai.

Testų vykdymas¶

Norėdami prisidėti, turėsite išsisaugoti šaltinį iš "GitHub" ir įdiegti "Guzzle" priklausomybes naudodami "Composer":

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

"Guzzle" testuojama naudojant "PHPUnit". Testus paleiskite naudodami Makefile:

make test

Pastaba

Norint atlikti integraciją, reikia įdiegti node.js v8 arba naujesnę versiją. Guzzle HTTP tvarkyklių integracinius bandymus.

Pranešimas apie saugumo pažeidžiamumą¶

Norime užtikrinti, kad "Guzzle" būtų saugi HTTP kliento biblioteka visiems. Jei aptikote "Guzzle" saugumo spragų, būsime dėkingi už pagalbą. atskleidžiant ją mums atsakingai.

Viešai atskleidus pažeidžiamumą gali kilti pavojus visai bendruomenei. Jei aptikote saugumo problemą, rašykite mums el. paštu security@guzzlephp.org. Dirbsime kartu su jumis, kad įsitikintume, jog suprantame problemos apimtį ir kad visiškai atsižvelgsime į jums rūpimą klausimą. Mes atsižvelgiame į korespondenciją, siunčiamą adresu security@guzzlephp.org, savo aukščiausiu prioritetu ir stengiamės kuo greičiau spręsti visas iškilusias problemas.

Ištaisius saugumo pažeidžiamumą, kuo greičiau bus išleistas saugumo pataisų leidinys.

Turinys