Yleiskatsaus¶

Vaatimukset¶

PHP 7.2.5
Jotta voit käyttää PHP:n stream-käsittelijää, allow_url_fopen on otettava käyttöön omassa järjestelmän php.ini-tiedostossa.
Jotta voit käyttää cURL-käsittelijää, sinulla on oltava cURL:n uusin versio >= 7.19.4 joka on käännetty OpenSSL:n ja zlibin kanssa.

Huomautus

Guzzle ei enää vaadi cURL:ää HTTP-pyyntöjen lähettämiseen. Guzzle käyttää PHP stream wrapperia HTTP-pyyntöjen lähettämiseen, jos cURL:ää ei ole asennettu. Vaihtoehtoisesti voit tarjota oman HTTP-käsittelijän, jota käytetään pyyntöjen lähettämiseen. Muista, että cURL tarvitaan edelleen samanaikaisten pyyntöjen lähettämiseen.

Asennus¶

Suositeltava tapa asentaa Guzzle on asentaa Composer. Composer on riippuvuuksien hallintatyökalu. PHP:lle, jonka avulla voit ilmoittaa projektisi tarvitsemat riippuvuudet ja asentaa ne projektiisi.

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

Voit lisätä Guzzlen riippuvuussuhteeksi Composerin avulla:

composer require guzzlehttp/guzzle:^7.0

Vaihtoehtoisesti voit määrittää Guzzlen riippuvuudeksi projektisi olemassa olevaan composer.json-tiedostoon:

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

Asennuksen jälkeen sinun on vaadittava Composerin autoloader:

require 'vendor/autoload.php';

Lisätietoja Composerin asentamisesta, automaattisen latauksen konfiguroinnista ja muista parhaista käytännöistä riippuvuuksien määrittelyssä löydät osoitteesta getcomposer.org.

Bleeding edge¶

Kehityksen aikana voit pysyä master-haaran viimeisimpien muutosten tasalla asettamalla Guzzlen versiovaatimukseksi ^7.0@dev.

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

Lisenssi¶

Lisensoitu käyttäen MIT-lisenssiä.

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

Myönnetään täten kaikille henkilöille, jotka saavat jäljennöksen, maksutta lupa tästä ohjelmistosta ja siihen liittyvistä dokumentaatiotiedostoista ("ohjelmisto"), käsitellä ohjelmistoon ilman rajoituksia, mukaan lukien rajoituksetta oikeudet käyttää, kopioida, muuttaa, yhdistää, julkaista, levittää, alilisensoida ja/tai myydä kopioita ohjelmistosta, ja sallia henkilöille, joille ohjelmisto on tehdä niin, seuraavin ehdoin:

Yllä oleva tekijänoikeusilmoitus ja tämä lupailmoitus on sisällytettävä kaikkiin ohjelmiston kopioihin tai merkittäviin osiin.

OHJELMISTO TARJOTAAN "SELLAISENA KUIN SE ON", ILMAN MINKÄÄNLAISTA TAKUUTA, NIMENOMAISTA TAI IMPLISIITTINEN, MUKAAN LUKIEN MUTTA EI RAJOITTUEN MYYNTIKELPOISUUTTA KOSKEVIIN TAKUISIIN, SOVELTUVUUS TIETTYYN TARKOITUKSEEN JA LOUKKAAMATTOMUUS. MISSÄÄN TAPAUKSESSA TEKIJÄT TAI TEKIJÄNOIKEUKSIEN HALTIJAT OLE VASTUUSSA MISTÄÄN VAATIMUKSISTA, VAHINGOISTA TAI MUISTA VASTUUSTA, OLIPA KYSE SITTEN SOPIMUSPERUSTEISESTA, VAHINGONKORVAUSOIKEUDELLISESTA TAI MUUSTA KANTEESTA, JOKA JOHTUU SEURAAVISTA, OHJELMISTOSTA TAI SEN KÄYTÖSTÄ TAI MUUSTA KÄSITTELYSTÄ TAI SEN YHTEYDESSÄ. OHJELMISTON KÄYTTÖÖN.

Osallistuminen¶

Ohjeet¶

Guzzle käyttää PSR-1:tä, PSR-2:ta, PSR-4:ää ja PSR-7:ää.
Guzzlen on tarkoitus olla kevyt ja nopea ja sisältää hyvin vähän riippuvuuksia. Tämä tarkoittaa, että että jokaista ominaisuuspyyntöä ei hyväksytä.
Guzzlen PHP-version vähimmäisvaatimus on PHP 7.2. Pull-pyyntöjen on oltava ei saa vaatia suurempaa PHP-versiota kuin PHP 7.2, paitsi jos ominaisuus on ainoastaan vain ehdollisesti ja tiedosto voidaan analysoida PHP 7.2:lla.
Kaikkien pull-pyyntöjen on sisällettävä yksikkötestit, joilla varmistetaan, että muutos toimii kuten odotetusti ja estämään regressiot.

Testien suorittaminen¶

Jotta voit osallistua, sinun on otettava lähdekoodi GitHubista ja asennettava Guzzlen riippuvuudet Composerin avulla:

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

Guzzle on yksikkötestattu PHPUnitilla. Suorita testit Makefile-tiedoston avulla:

make test

Huomautus

Sinun on asennettava node.js v8 tai uudempi, jotta voit suorittaa integroinnin. testejä Guzzlen HTTP-käsittelijöille.

Turvallisuushaavoittuvuudesta ilmoittaminen¶

Haluamme varmistaa, että Guzzle on turvallinen HTTP-asiakaskirjasto kaikille. Jos olet löytänyt Guzzlessa tietoturva-aukon, arvostamme apuasi. sen paljastamisessa meille vastuullisella tavalla.

Haavoittuvuuden julkistaminen voi asettaa koko yhteisön vaaraan. Jos olet havainnut tietoturvaongelman, lähetä meille sähköpostia osoitteeseen security@guzzlephp.org.. Työskentelemme kanssasi varmistaaksemme, että ymmärrämme ongelman laajuuden ja että käsittelemme huolenaiheesi täysin. Otamme huomioon security@guzzlephp.org -osoitteeseen lähetettyä kirjeenvaihtoa ensisijaisena, ja pyrimme puuttua kaikkiin esiin tuleviin ongelmiin mahdollisimman nopeasti.

Kun tietoturva-aukko on korjattu, tietoturvakorjaus julkaistaan mahdollisimman pian.

Sisällysluettelo