Ülevaade

Nõuded

  1. PHP 7.2.5
  2. PHP voogkäsitleja kasutamiseks peab allow_url_fopen olema lubatud teie programmis. süsteemi php.ini.
  3. cURL-käsitleja kasutamiseks peab teil olema cURLi uusim versioon >= 7.19.4. mis on kompileeritud koos OpenSSL-i ja zlibiga.

Märkus

Guzzle ei nõua enam cURL-i, et saata HTTP-päringuid. Guzzle hakkab kasutab HTTP-päringute saatmiseks PHP voogedastust, kui cURL ei ole paigaldatud. Te võite alternatiivina pakkuda omaenda HTTP-käsitlejat, mida kasutatakse päringute saatmiseks. Pidage meeles, et cURL on endiselt vajalik samaaegsete päringute saatmiseks.

Installatsioon

Soovitatav viis Guzzle'i paigaldamiseks on koos Composer. Composer on sõltuvuste haldamise vahend PHP jaoks, mis võimaldab teil deklareerida oma projektile vajalikud sõltuvused ja installeerib need teie projekti.

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

Saate lisada Guzzle'i sõltuvusena, kasutades Composerit:

composer require guzzlehttp/guzzle:^7.0

Alternatiivina võite määrata Guzzle'i sõltuvusena oma projekti olemasolevas composer.json failis:

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

Pärast paigaldamist peate nõudma Composeri autoloader'i:

require 'vendor/autoload.php';

Lisateavet Composeri paigaldamise, automaatse laadimise seadistamise ja muude sõltuvuste määratlemise parimate tavade kohta leiate aadressil getcomposer.org.

Bleeding edge

Arenduse ajal saate hoida end kursis viimaste muudatustega master-harus, seades Guzzle'i versiooninõude ^7.0@dev.

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

Litsents

Litsentseeritud kasutades MIT litsentsi.

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

Käesolevaga antakse tasuta luba igale isikule, kes soovib saada koopiat järgmisest dokumendist selle tarkvara ja sellega seotud dokumentatsioonifailide (edaspidi "tarkvara"), et tegeleda tarkvaraga ilma piiranguteta, kaasa arvatud, kuid mitte ainult, õigused kasutada, kopeerida, muuta, ühendada, avaldada, levitada, all-litsentseerida ja/või müüa. tarkvara koopiaid, ning lubada isikutel, kellele tarkvara on seda teha järgmistel tingimustel:

Ülaltoodud autoriõiguse teatis ja käesolev loateade peavad sisalduma kõigis tarkvara koopiates või olulistes osades.

TARKVARA ON ESITATUD "NAGU ON", ILMA IGASUGUSE GARANTIITA, OTSESE VÕI VAIKIMISI, SEALHULGAS, KUID MITTE AINULT, GARANTIID KAUBAKÕLBLIKKUSE KOHTA, SOBIVUSE KOHTA KONKREETSEKS OTSTARBEKS JA RIKKUMISE PUUDUMISE KOHTA. MITTE MINGIL JUHUL EI TOHI AUTORID VÕI AUTORIÕIGUSTE OMANIKUD EI VASTUTA MIS TAHES NÕUETE, KAHJUDE VÕI MUUDE KAHJUDE EEST. VASTUTUSE EEST, OLENEMATA SELLEST, KAS SEE TULENEB LEPINGUST, DELIKTIÕIGUSEST VÕI MUUL VIISIL, TARKVARAST VÕI SELLE KASUTAMISEST VÕI MUUDEST TEHINGUTEST, MIS TULENEVAD VÕI ON SEOTUD TARKVARAGA VÕI SELLE KASUTAMISEGA. TARKASTAMISEGA.

Panustamine

Suunised

  1. Guzzle kasutab PSR-1, PSR-2, PSR-4 ja PSR-7.
  2. Guzzle on mõeldud olema lahja ja kiire ning väga väheste sõltuvustega. See tähendab, et et mitte iga funktsioonitaotlus ei ole vastuvõetav.
  3. Guzzle'i minimaalne PHP-versiooninõue on PHP 7.2. Tõmbepäringud peavad olema ei tohi nõuda PHP versiooni, mis on suurem kui PHP 7.2, välja arvatud juhul, kui funktsioon on ainult kasutatakse ainult tingimuslikult ja faili saab analüüsida PHP 7.2 abil.
  4. Kõik tõmbetaotlused peavad sisaldama teste, et tagada, et muudatus töötab nii, nagu on ette nähtud. oodatud ja et vältida regressioone.

Testide läbiviimine

Selleks, et anda oma panus, peate GitHubist lähtekoodi välja võtma ja Composeri abil Guzzle'i sõltuvused installeerima:

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

Guzzle'i testitakse PHPUnitiga. Käivitage testid Makefile'i abil:

make test

Märkus

Integratsiooni teostamiseks on vaja paigaldada node.js v8 või uuem, et teostada integratsiooni teste Guzzle'i HTTP-käsitlejate kohta.

Turvaaukust teatamine

Me tahame tagada, et Guzzle oleks kõigile turvaline HTTP-kliendibaas. Kui olete avastanud Guzzle'is turvaaugu, oleme tänulikud teie abi eest. selle avalikustamisel meile vastutustundlikul viisil.

Haavatavuse avalikustamine võib ohustada kogu kogukonda. Kui olete avastanud turvaprobleemi, saatke meile e-kiri aadressil security@guzzlephp.org. Me teeme teiega koostööd, et veenduda, et me mõistame probleemi ulatust ja et me tegeleme täielikult teie murega. Me kaalume security@guzzlephp.org saadetud kirjavahetust meie kõrgeimaks prioriteediks ja töötame selle nimel, et lahendada kõik tekkivad probleemid võimalikult kiiresti.

Kui turvaauk on parandatud, võetakse võimalikult kiiresti kasutusele turvaparandus.