Oversigt

Krav

  1. PHP 7.2.5
  2. For at kunne bruge PHP-stream-handleren skal allow_url_fopen være aktiveret i din systemets php.ini.
  3. For at bruge cURL-handleren skal du have en nyere version af cURL >= 7.19.4 kompileret med OpenSSL og zlib.

Bemærk

Guzzle kræver ikke længere cURL for at sende HTTP-forespørgsler. Guzzle vil bruge PHP stream wrapper til at sende HTTP-forespørgsler, hvis cURL ikke er installeret. Alternativt kan du angive din egen HTTP-handler, der bruges til at sende anmodninger. Husk på, at cURL stadig er påkrævet for at sende samtidige anmodninger.

Installation

Den anbefalede måde at installere Guzzle på er med Composer. Composer er et værktøj til styring af afhængigheder for PHP, der giver dig mulighed for at erklære de afhængigheder, dit projekt har brug for, og installerer dem i dit projekt.

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

Du kan tilføje Guzzle som en afhængighed ved hjælp af Composer:

composer require guzzlehttp/guzzle:^7.0

Alternativt kan du angive Guzzle som en afhængighed i dit projekts eksisterende composer.json-fil:

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

Når du har installeret, skal du kræve Composers autoloader:

require 'vendor/autoload.php';

Du kan få mere at vide om, hvordan du installerer Composer, konfigurerer autoloading og andre bedste fremgangsmåder til at definere afhængigheder på getcomposer.org.

Blødende kant

Under din udvikling kan du følge med de seneste ændringer i mastergrenen ved at indstille versionskravet for Guzzle til ^7.0@dev.

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

Licens

Licenseret under MIT-licens.

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

Der gives hermed gratis tilladelse til, at enhver, der ønsker at få en kopi af denne software og tilhørende dokumentationsfiler ("Softwaren"), til at handle med i softwaren uden begrænsning, herunder uden begrænsning rettighederne til at bruge, kopiere, ændre, sammenføje, offentliggøre, distribuere, underlicensere og/eller sælge kopier af softwaren, og til at tillade personer, til hvem softwaren er til at gøre dette, på følgende betingelser:

Ovenstående meddelelse om ophavsret og denne meddelelse om tilladelse skal være indeholdt i alle kopier eller væsentlige dele af softwaren.

SOFTWAREN LEVERES "SOM DEN ER", UDEN NOGEN FORM FOR GARANTI, HVERKEN UDTRYKKELIG ELLER UNDERFORSTÅET, HERUNDER, MEN IKKE BEGRÆNSET TIL, GARANTIERNE FOR SALGBARHED, EGNETHED TIL ET BESTEMT FORMÅL OG IKKE-KRÆNKELSE. UNDER INGEN OMSTÆNDIGHEDER MÅ FORFATTERE ELLER INDEHAVERE AF OPHAVSRET VÆRE ANSVARLIGE FOR ETHVERT KRAV, ERSTATNING ELLER ANDEN ANSVAR, UANSET OM DET ER I EN KONTRAKTSAG, EN ERSTATNINGSSAG ELLER PÅ ANDEN MÅDE, DER OPSTÅR SOM FØLGE AF, AF ELLER I FORBINDELSE MED SOFTWAREN ELLER BRUGEN ELLER ANDEN OMGANG MED SOFTWAREN.

Bidrag

Retningslinjer

  1. Guzzle anvender PSR-1, PSR-2, PSR-4 og PSR-7.
  2. Guzzle er beregnet til at være slank og hurtig med meget få afhængigheder. Det betyder at ikke alle anmodninger om funktioner vil blive accepteret.
  3. Guzzle har et krav om en PHP-version på mindst PHP 7.2. Pull requests skal ikke kræve en PHP-version større end PHP 7.2, medmindre funktionen kun er kun anvendes betinget, og filen kan analyseres af PHP 7.2.
  4. Alle pull requests skal indeholde enhedstests for at sikre, at ændringen fungerer som forventet og for at forhindre regressioner.

Gennemførelse af testene

For at kunne bidrage skal du tjekke kildekoden fra GitHub og installere Guzzles afhængigheder ved hjælp af Composer:

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

Guzzle er enhedstestet med PHPUnit. Kør testene ved hjælp af Makefile:

make test

Bemærk

Du skal installere node.js v8 eller nyere for at kunne udføre integrationen test af Guzzles HTTP-håndterer.

Rapportering af en sikkerhedssårbarhed

Vi ønsker at sikre, at Guzzle er et sikkert HTTP-klientbibliotek for alle. Hvis du har opdaget en sikkerhedssårbarhed i Guzzle, er vi glade for din hjælp med at afsløre den for os på en ansvarlig måde.

Offentliggørelse af en sårbarhed kan bringe hele samfundet i fare. Hvis du har opdaget et sikkerhedsproblem, bedes du sende os en e-mail på security@guzzlephp.orgorg. Vi vil samarbejde med dig for at sikre, at vi forstår de omfanget af problemet, og at vi tager fuldt ud fat på din bekymring. Vi overvejer korrespondance sendt til security@guzzlephp.org vores højeste prioritet, og arbejder på at løse eventuelle problemer, der opstår, så hurtigt som muligt.

Når en sikkerhedssårbarhed er blevet rettet, vil der blive udsendt et sikkerheds-hotfix så hurtigt som muligt.