Prezentare generală¶

Cerințe¶

PHP 7.2.5
Pentru a utiliza gestionarul de fluxuri PHP, allow_url_fopen trebuie să fie activat în fișierul dvs. php.ini al sistemului.
Pentru a utiliza gestionarul cURL, trebuie să aveți o versiune recentă de cURL >= 7.19.4 compilată cu OpenSSL și zlib.

Notă

Guzzle nu mai are nevoie de cURL pentru a trimite cereri HTTP. Guzzle va va utiliza învelișul de flux PHP pentru a trimite cereri HTTP dacă nu este instalat cURL. Alternativ, puteți furniza propriul gestionar HTTP utilizat pentru a trimite cereri. Rețineți că cURL este în continuare necesar pentru a trimite cereri simultane.

Instalare¶

Modul recomandat de instalare a Guzzle este cu Composer. Composer este un instrument de gestionare a dependențelor pentru PHP, care vă permite să declarați dependențele de care proiectul dvs. are nevoie și le instalează în proiectul dvs.

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

Puteți adăuga Guzzle ca dependență folosind Composer:

composer require guzzlehttp/guzzle:^7.0

Alternativ, puteți specifica Guzzle ca o dependență în fișierul composer.json existent al proiectului dumneavoastră:

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

După instalare, trebuie să solicitați autoloaderul lui Composer:

require 'vendor/autoload.php';

Puteți afla mai multe despre cum să instalați Composer, să configurați încărcarea automată și alte bune practici pentru definirea dependențelor la getcomposer.org.

Marginea de sângerare¶

În timpul dezvoltării, puteți ține pasul cu cele mai recente modificări de pe ramura principală prin setarea cerinței de versiune pentru Guzzle la ^7.0@dev.

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

Licență¶

Licențiat folosind MIT license.

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

Prin prezenta se acordă permisiunea, cu titlu gratuit, oricărei persoane care obține o copie a acestui software și a fișierelor de documentație asociate (denumit în continuare "Software"), de a utiliza fără restricții, inclusiv, fără a se limita la drepturile de a utiliza, copia, modifica, îmbina, publica, distribui, sublicenția și/sau vinde copii ale Software-ului, și de a permite persoanelor cărora Software-ul le este furnizat Software-ul să facă acest lucru, sub rezerva următoarelor condiții:

Notificarea privind drepturile de autor de mai sus și această notificare de permisiune vor fi incluse în toate copiile sau părțile substanțiale ale software-ului.

SOFTWARE-UL ESTE FURNIZAT "AȘA CUM ESTE", FĂRĂ NICIO GARANȚIE DE NICIUN FEL, EXPRESĂ SAU IMPLICITĂ, INCLUSIV, DAR FĂRĂ A SE LIMITA LA GARANȚIILE DE VANDABILITATE, ADECVAREA LA UN ANUMIT SCOP ȘI NERESPECTAREA DREPTURILOR. ÎN NICIUN CAZ NU SE VA APLICA AUTORII SAU DEȚINĂTORII DREPTURILOR DE AUTOR SĂ FIE RĂSPUNZĂTORI PENTRU ORICE PRETENȚII, DAUNE SAU ALTE RĂSPUNDERE, FIE ÎNTR-O ACȚIUNE CONTRACTUALĂ, DELICTUALĂ SAU DE ALTĂ NATURĂ, CARE REZULTĂ DIN, DIN SAU ÎN LEGĂTURĂ CU SOFTWARE-UL SAU CU UTILIZAREA SAU ALTE TRANZACȚII CU ACESTA. SOFTWARE.

Contribuții¶

Orientări¶

Guzzle utilizează PSR-1, PSR-2, PSR-4 și PSR-7.
Guzzle este conceput pentru a fi simplu și rapid, cu foarte puține dependențe. Acest lucru înseamnă că că nu toate cererile de caracteristici vor fi acceptate.
Guzzle necesită o versiune minimă a PHP de PHP 7.2. Cererile de tip pull trebuie nu necesită o versiune PHP mai mare decât PHP 7.2, cu excepția cazului în care caracteristica este doar utilizată în mod condiționat și fișierul poate fi analizat de PHP 7.2.
Toate solicitările pull trebuie să includă teste unitare pentru a se asigura că modificarea funcționează așa cum așteptat și pentru a preveni regresiile.

Efectuarea testelor¶

Pentru a contribui, va trebui să descărcați sursa de pe GitHub și să instalați dependențele Guzzle folosind Composer:

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

Guzzle este testat unitar cu PHPUnit. Rulați testele folosind fișierul Makefile:

make test

Notă

Va trebui să instalați node.js v8 sau o versiune mai nouă pentru a efectua integrarea pentru a efectua teste de integrare pe gestionarii HTTP ai Guzzle.

Raportarea unei vulnerabilități de securitate¶

Dorim să ne asigurăm că Guzzle este o bibliotecă client HTTP sigură pentru toată lumea. Dacă ați descoperit o vulnerabilitate de securitate în Guzzle, apreciem ajutorul dumneavoastră în a ne-o dezvălui într-un mod responsabil.

Dezvăluirea publică a unei vulnerabilități poate pune în pericol întreaga comunitate. Dacă ați descoperit o problemă de securitate, vă rugăm să ne trimiteți un e-mail la adresa security@guzzlephp.org. Vom lucra cu dvs. pentru a ne asigura că înțelegem amploarea problemei și că vom aborda pe deplin preocuparea dvs. Luăm în considerare corespondența trimisă la security@guzzlephp.org prioritatea noastră cea mai mare și lucrăm pentru a rezolvăm orice problemă care apare cât mai repede posibil.

După ce o vulnerabilitate de securitate a fost corectată, se va lansa o versiune de corecție de securitate în cel mai scurt timp posibil.

Cuprins