Áttekintés¶

Követelmények¶

PHP 7.2.5
A PHP stream kezelő használatához allow_url_fopen engedélyezve kell lennie az Ön weboldalán. rendszer php.ini fájljában.
A cURL kezelő használatához a cURL >= 7.19.4 legújabb verziója szükséges. OpenSSL-lel és zlib-bel fordítva.

Megjegyzés:

A Guzzle már nem igényel cURL-t a HTTP-kérések küldéséhez. A Guzzle a PHP stream wrapper-t használja a HTTP-kérések küldéséhez, ha a cURL nincs telepítve. Alternatívaként megadhatja saját HTTP kezelőjét is, amelyet a kérések küldéséhez használ. Ne feledje, hogy a cURL továbbra is szükséges az egyidejű kérések küldéséhez.

Telepítés¶

A Guzzle telepítésének ajánlott módja a következő Composer. A Composer egy függőségkezelő eszköz. PHP-hez, amely lehetővé teszi, hogy deklarálja a projektjének szükséges függőségeket és a telepíti őket a projektedbe.

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

A Guzzle-t függőségként hozzáadhatja a Composer segítségével:

composer require guzzlehttp/guzzle:^7.0

Alternatívaként a Guzzle-t függőségként is megadhatja a projekt meglévő composer.json fájljában:

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

A telepítés után szükség van a Composer automatikus betöltőjére:

require 'vendor/autoload.php';

A getcomposer.org oldalon többet megtudhat a Composer telepítéséről, az automatikus betöltés beállításáról és a függőségek meghatározásának egyéb legjobb gyakorlatairól.

Vérző szélek¶

A fejlesztés során lépést tarthatsz a master ág legújabb változásaival, ha a Guzzle verziókövetelményét ^[email protected] értékre állítod.

{
   "require": {
      "guzzlehttp/guzzle": "^[email protected]"
   }
}

Licenc¶

Licencelve a MIT licenc alapján.

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

Ezúton engedélyezzük, hogy bárki, aki másolatot szerez, díjmentesen megkapja a következőket e szoftver és a kapcsolódó dokumentációs fájlok (a "Szoftver"), a következőkre vonatkozóan a Szoftverre korlátozás nélkül, beleértve, de nem korlátozva a következő jogokat a szoftver használatára, másolására, módosítására, egyesítésére, közzétételére, terjesztésére, allicencbe adására és/vagy értékesítésére. a Szoftver másolatainak értékesítésére, valamint arra, hogy engedélyezze azon személyek számára, akiknek a Szoftvert az alábbi feltételek mellett:

A fenti szerzői jogi közleményt és ezt az engedélyezési közleményt a Szoftver minden példányának vagy jelentős részének tartalmaznia kell.

A SZOFTVERT "ÚGY, AHOGY VAN", BÁRMIFÉLE GARANCIA NÉLKÜL, KIFEJEZETT VAGY HALLGATÓLAGOS, BELEÉRTVE, DE NEM KIZÁRÓLAGOSAN AZ ELADHATÓSÁGI GARANCIÁKAT, A MEGHATÁROZOTT CÉLRA VALÓ ALKALMASSÁGRA ÉS A JOGSÉRTÉSMENTESSÉGRE. SEMMILYEN KÖRÜLMÉNYEK KÖZÖTT A SZERZŐK VAGY A SZERZŐI JOGTULAJDONOSOK SEMMILYEN KÖVETELÉSÉRT, KÁRÉRT VAGY EGYÉB FELELŐSSÉGÉRT, AKÁR SZERZŐDÉSES, KÁRTÉRÍTÉSI VAGY MÁS JOGCÍMEN, AMELY A KÖVETKEZŐKBŐL ERED, A SZOFTVERREL, ILLETVE A SZOFTVER HASZNÁLATÁVAL VAGY MÁS, A SZOFTVERREL VALÓ KAPCSOLATTARTÁSSAL KAPCSOLATOS A SZOFTVER.

Hozzájárulás¶

Irányelvek¶

A Guzzle a PSR-1, PSR-2, PSR-4 és PSR-7 rendszereket használja.
A Guzzle célja, hogy karcsú és gyors legyen, nagyon kevés függőséggel. Ez azt jelenti, hogy hogy nem minden funkciókérés kerül elfogadásra.
A Guzzle minimális PHP verziókövetelménye a PHP 7.2. A pull kéréseknek nem igényelhetnek PHP 7.2-nél nagyobb PHP verziót, kivéve, ha a funkció csak a csak feltételesen használható, és a fájl a PHP 7.2 által elemezhető.
Minden pull-kérelemnek tartalmaznia kell egységteszteket, hogy a változtatás úgy működjön, ahogyan az és megakadályozza a regressziót.

A tesztek futtatása¶

Ahhoz, hogy hozzájárulhass, ki kell töltened a forrást a GitHubról, és telepítened kell a Guzzle függőségeit a Composer segítségével:

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

A Guzzle-t a PHPUnit segítségével tesztelik. Futtassa a teszteket a Makefile segítségével:

make test

Megjegyzés:

Az integrációhoz telepítenie kell a node.js v8 vagy újabb verzióját. tesztek elvégzéséhez a Guzzle HTTP-kezelőin.

Biztonsági rés bejelentése¶

Szeretnénk biztosítani, hogy a Guzzle mindenki számára biztonságos HTTP klienskönyvtár legyen. Ha a biztonsági rést fedezett fel a Guzzle-ben, értékeljük a segítségét. hogy felelős módon nyilvánosságra hozza azt számunkra.

Egy sebezhetőség nyilvánosságra hozatala az egész közösséget veszélybe sodorhatja. Ha a biztonsági problémát fedezett fel, kérjük, küldjön e-mailt az alábbi címre security@guzzlephp.org.. Együtt fogunk dolgozni önnel, hogy megbizonyosodjunk arról, hogy megértettük a a probléma terjedelmét, és hogy teljes mértékben foglalkozunk az Ön problémájával. Úgy véljük A security@guzzlephp.org címre küldött leveleket a legmagasabb prioritásként kezeljük, és azon dolgozunk, hogy a lehető leggyorsabban kezeljük a felmerülő problémákat.

A biztonsági rés kijavítása után a lehető leghamarabb biztonsági frissítés kiadására kerül sor.

Tartalomjegyzék