Översikt¶

Krav¶

PHP 7.2.5
För att kunna använda PHP:s strömhanterare måste allow_url_fopen vara aktiverat i din systemets php.ini.
För att använda cURL-hanteraren måste du ha en nyare version av cURL >= 7.19.4 kompilerad med OpenSSL och zlib.

Obs

Guzzle kräver inte längre cURL för att skicka HTTP-förfrågningar. Guzzle kommer att använda PHP stream wrapper för att skicka HTTP-förfrågningar om cURL inte är installerat. Alternativt kan du tillhandahålla din egen HTTP-hanterare som används för att skicka förfrågningar. Tänk på att cURL fortfarande krävs för att skicka samtidiga förfrågningar.

Installation¶

Det rekommenderade sättet att installera Guzzle är med Composer. Composer är ett verktyg för hantering av beroenden. för PHP som gör att du kan deklarera de beroenden som ditt projekt behöver och installerar dem i ditt projekt.

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

Du kan lägga till Guzzle som ett beroende med Composer:

composer require guzzlehttp/guzzle:^7.0

Alternativt kan du ange Guzzle som ett beroende i projektets befintliga composer.json-fil:

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

Efter installationen måste du kräva Composers autoloader:

require 'vendor/autoload.php';

Du kan läsa mer om hur du installerar Composer, konfigurerar autoloading och andra bästa metoder för att definiera beroenden på getcomposer.org.

Blödande kant¶

Under utvecklingen kan du följa med de senaste ändringarna i mastergrenen genom att ställa in versionskravet för Guzzle till ^7.0@dev.

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

Licens¶

Licensieras med hjälp av MIT-licensen.

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

Härmed ges tillstånd att kostnadsfritt ge en kopia till alla som vill ha en kopia av följande av denna programvara och tillhörande dokumentationsfiler ("Programvaran"), att handla med i programvaran utan begränsning, inklusive och utan begränsning av rättigheterna att använda, kopiera, ändra, sammanfoga, publicera, distribuera, underlicensiera och/eller sälja kopior av programvaran, och att tillåta personer till vilka programvaran är som får ta del av programvaran att göra detta, med förbehåll för följande villkor:

Ovanstående upphovsrättsmeddelande och detta tillståndsmeddelande ska ingå i alla kopior eller väsentliga delar av programvaran.

PROGRAMVARAN TILLHANDAHÅLLS "I BEFINTLIGT SKICK", UTAN NÅGON SOM HELST GARANTI, UTTRYCKLIG ELLER UNDERFÖRSTÅTT, INKLUSIVE MEN INTE BEGRÄNSAT TILL GARANTIER FÖR SÄLJBARHET, LÄMPLIGHET FÖR ETT VISST ÄNDAMÅL OCH ICKE ÖVERTRÄDELSE. UNDER INGA OMSTÄNDIGHETER FÅR FÖRFATTARNA ELLER UPPHOVSRÄTTSINNEHAVARNA VARA ANSVARIGA FÖR ALLA ANSPRÅK, SKADOR ELLER ANDRA ANSVAR, OAVSETT OM DET RÖR SIG OM EN KONTRAKTSHANDLING, SKADESTÅND ELLER ANNAT, SOM HÄRRÖR FRÅN, ELLER I SAMBAND MED PROGRAMVARAN ELLER ANVÄNDNING ELLER ANNAN HANTERING AV DEN. PROGRAMVARAN.

Bidrag¶

Riktlinjer¶

Guzzle använder PSR-1, PSR-2, PSR-4 och PSR-7.
Guzzle är tänkt att vara smidigt och snabbt med väldigt få beroenden. Detta innebär att att inte alla önskemål om funktioner kommer att accepteras.
Guzzle har ett krav på en PHP-version på minst PHP 7.2. Begäran om dragning måste inte kräva en PHP-version som är större än PHP 7.2 om inte funktionen endast är en används endast på villkor och filen kan analyseras av PHP 7.2.
Alla pull-förfrågningar måste innehålla enhetstester för att säkerställa att ändringen fungerar som den ska. förväntat och för att förhindra regressioner.

Kör testerna¶

För att kunna bidra måste du hämta källkoden från GitHub och installera Guzzles beroenden med Composer:

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

Guzzle är enhetstestat med PHPUnit. Kör testerna med hjälp av Makefile:

make test

Obs

Du måste installera node.js v8 eller nyare för att kunna utföra integrationen. tester på Guzzles HTTP-hanterare.

Rapportera en säkerhetsbrist¶

Vi vill se till att Guzzle är ett säkert HTTP-klientbibliotek för alla. Om du har upptäckt en säkerhetssårbarhet i Guzzle, uppskattar vi din hjälp. med att avslöja den för oss på ett ansvarsfullt sätt.

Om en sårbarhet avslöjas offentligt kan hela samhället utsättas för en risk. Om du har upptäckt ett säkerhetsproblem, skicka ett e-postmeddelande till oss på security@guzzlephp.org. Vi kommer att samarbeta med dig för att se till att vi förstår vad du vill ha. problemets omfattning och att vi tar itu med ditt problem fullt ut. Vi tar hänsyn till följande korrespondens som skickas till security@guzzlephp.org vår högsta prioritet, och arbetar för att att åtgärda eventuella problem som uppstår så snabbt som möjligt.

När en säkerhetssårbarhet har korrigerats kommer en säkerhetshjälpsversion att distribueras så snart som möjligt.

Innehållsförteckning