Übersicht¶

Anforderungen¶

PHP 7.2.5
Um den PHP Stream Handler zu verwenden, muss allow_url_fopen in Ihrer php.ini Ihres Systems aktiviert sein.
Um den cURL-Handler zu verwenden, müssen Sie eine aktuelle Version von cURL >= 7.19.4 mit OpenSSL und zlib kompiliert haben.

Hinweis

Guzzle benötigt nicht mehr cURL, um HTTP-Anfragen zu senden. Guzzle wird verwendet den PHP-Stream-Wrapper, um HTTP-Anfragen zu senden, wenn cURL nicht installiert ist. Alternativ können Sie auch einen eigenen HTTP-Handler zum Senden von Anfragen bereitstellen. Denken Sie daran, dass cURL immer noch erforderlich ist, um gleichzeitige Anfragen zu senden.

Installation¶

Die empfohlene Art, Guzzle zu installieren, ist mit Composer. Composer ist ein Werkzeug zur Verwaltung von Abhängigkeiten für PHP, mit dem Sie die Abhängigkeiten, die Ihr Projekt benötigt, deklarieren können und installiert sie in Ihr Projekt.

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

Sie können Guzzle mit Composer als Abhängigkeit hinzufügen:

composer require guzzlehttp/guzzle:^7.0

Alternativ können Sie Guzzle als Abhängigkeit in der bestehenden composer.json-Datei Ihres Projekts angeben:

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

Nach der Installation müssen Sie den Autoloader von Composer anfordern:

require 'vendor/autoload.php';

Weitere Informationen über die Installation von Composer, die Konfiguration von Autoloading und andere Best Practices für die Definition von Abhängigkeiten finden Sie unter getcomposer.org.

Bleeding edge¶

Während der Entwicklung können Sie mit den neuesten Änderungen im Master-Zweig Schritt halten, indem Sie die Versionsanforderung für Guzzle auf ^7.0@dev setzen.

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

Lizenz¶

Lizensiert unter der MIT-Lizenz.

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

Hiermit wird jeder Person, die eine Kopie dieser Software und der zugehörigen Dokumentationsdateien (die "Software") erwirbt, die kostenlose Erlaubnis erteilt dieser Software und der zugehörigen Dokumentationsdateien (die "Software") erhält, das Recht der Software ohne Einschränkung zu handeln, einschließlich und ohne Einschränkung der Rechte zu nutzen, zu kopieren, zu modifizieren, zusammenzuführen, zu veröffentlichen, zu vertreiben, zu unterlizenzieren und/oder zu verkaufen der Software zu nutzen, zu kopieren, zu modifizieren, zu veröffentlichen, zu vertreiben, zu unterlizenzieren und/oder zu verkaufen, und zu erlauben, dies zu tun, vorbehaltlich der folgenden Bedingungen:

Der obige Copyright-Hinweis und dieser Genehmigungshinweis müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.

DIE SOFTWARE WIRD OHNE MÄNGELGEWÄHR UND OHNE JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGEND, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIE GARANTIE DER MARKTGÄNGIGKEIT, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND NICHTVERLETZUNG VON RECHTEN DRITTER. IN KEINEM FALL SIND DIE DIE AUTOREN ODER URHEBERRECHTSINHABER FÜR JEGLICHE ANSPRÜCHE, SCHÄDEN ODER ANDERE HAFTUNG, SEI ES AUS VERTRAG, UNERLAUBTER HANDLUNG ODER ANDERWEITIG, DIE SICH AUS, AUS ODER IN VERBINDUNG MIT DER SOFTWARE ODER DER NUTZUNG ODER DEM SONSTIGEN UMGANG MIT DER SOFTWARE.

Beitragen¶

Leitlinien¶

Guzzle verwendet PSR-1, PSR-2, PSR-4 und PSR-7.
Guzzle soll schlank und schnell sein und nur wenige Abhängigkeiten aufweisen. Das bedeutet dass nicht jede Funktionsanfrage angenommen wird.
Guzzle benötigt eine PHP-Version von mindestens PHP 7.2. Pull Requests dürfen eine PHP-Version größer als PHP 7.2 erfordern, es sei denn, die Funktion wird nur nur bedingt genutzt wird und die Datei von PHP 7.2 geparst werden kann.
Alle Pull Requests müssen Unit-Tests enthalten, um sicherzustellen, dass die Änderung wie erwartet funktioniert funktionieren und Regressionen verhindern.

Durchführung der Tests¶

Um einen Beitrag leisten zu können, müssen Sie den Quellcode von GitHub auschecken und die Abhängigkeiten von Guzzle mit Composer installieren:

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

Guzzle wird mit PHPUnit getestet. Führen Sie die Tests mit dem Makefile aus:

make test

Hinweis

Sie müssen node.js v8 oder neuer installieren, um Integrationstests Tests für die HTTP-Handler von Guzzle durchzuführen.

Meldung einer Sicherheitslücke¶

Wir wollen sicherstellen, dass Guzzle eine sichere HTTP-Client-Bibliothek für alle ist. Wenn Sie eine Sicherheitslücke in Guzzle entdeckt haben, freuen wir uns über Ihre Hilfe uns diese auf verantwortungsvolle Weise mitzuteilen.

Die öffentliche Bekanntgabe einer Schwachstelle kann die gesamte Gemeinschaft gefährden. Wenn Sie ein Sicherheitsproblem entdeckt haben, senden Sie uns bitte eine E-Mail an security@guzzlephp.org. Wir werden mit Ihnen zusammenarbeiten, um sicherzustellen, dass wir den Umfang des Problems verstehen und Ihr Anliegen vollständig berücksichtigen. Wir betrachten Korrespondenz, die an security@guzzlephp.org geschickt wird, hat für uns höchste Priorität, und wir arbeiten daran und arbeiten daran, auftretende Probleme so schnell wie möglich zu lösen.

Nachdem eine Sicherheitslücke behoben wurde, wird so schnell wie möglich ein Sicherheits-Hotfix veröffentlicht.

Inhaltsverzeichnis