Aperçu ¶

Exigences ¶

PHP 7.2.5
Pour utiliser le gestionnaire de flux de PHP, allow_url_fopen doit être activé dans votre dans le php.ini de votre système.
Pour utiliser le gestionnaire cURL, vous devez avoir une version récente de cURL >= 7.19.4 compilée avec OpenSSL et zlib.

Note

Guzzle n'a plus besoin de cURL pour envoyer des requêtes HTTP. Guzzle utilise le wrapper de flux PHP pour envoyer des requêtes HTTP si cURL n'est pas installé. Vous pouvez également fournir votre propre gestionnaire HTTP utilisé pour envoyer les requêtes. Gardez à l'esprit que cURL est toujours nécessaire pour envoyer des requêtes simultanées.

Installation¶

La méthode recommandée pour installer Guzzle est la suivante Composer. Composer est un outil de gestion des dépendances pour PHP qui vous permet de déclarer les dépendances dont votre projet a besoin et les installe dans votre projet.

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

Vous pouvez ajouter Guzzle en tant que dépendance à l'aide de Composer :

composer require guzzlehttp/guzzle:^7.0

Vous pouvez également spécifier Guzzle comme une dépendance dans le fichier composer.json existant de votre projet :

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

Après l'installation, vous devez avoir besoin de l'autoloader de Composer :

require 'vendor/autoload.php';

Pour en savoir plus sur l'installation de Composer, la configuration de l'autoloading et les meilleures pratiques en matière de définition des dépendances, consultez getcomposer.org.

Bleeding edge ¶

Pendant votre développement, vous pouvez suivre les dernières modifications de la branche master en définissant la version requise pour Guzzle à ^7.0@dev.

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

Licence ¶

Sous licence avec la licence MIT.

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

Par la présente, l'autorisation est accordée, à titre gratuit, à toute personne obtenant une copie de ce logiciel et des fichiers de documentation associés (le "logiciel"), d'en faire le commerce. de ce logiciel et des fichiers de documentation associés (le "Logiciel"), de traiter le le logiciel sans restriction, y compris, mais sans s'y limiter, le droit d'utiliser, de copier, de modifier, de fusionner, de publier, de distribuer, d'accorder une sous-licence et/ou de vendre et/ou de vendre des copies du logiciel, et d'autoriser les personnes à qui le logiciel est fourni à le faire, sous réserve des conditions suivantes le logiciel est fourni, sous réserve des conditions suivantes :

L'avis de copyright ci-dessus et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du logiciel.

LE LOGICIEL EST FOURNI " EN L'ÉTAT ", SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU EXPRESSE OU IMPLICITE, Y COMPRIS, MAIS SANS S'Y LIMITER, LES GARANTIES DE QUALITÉ MARCHANDE, MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET DE NON-VIOLATION. EN AUCUN CAS, LES AUTEURS EN AUCUN CAS, LES AUTEURS OU LES DÉTENTEURS DE DROITS D'AUTEUR NE POURRONT ÊTRE RESPONSABILITÉ, QUE CE SOIT DANS LE CADRE D'UNE ACTION CONTRACTUELLE, DÉLICTUELLE OU AUTRE, DÉCOULANT DE, OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU AUTRES TRANSACTIONS DU LOGICIEL. LE LOGICIEL.

Contribuer ¶

Lignes directrices ¶

Guzzle utilise PSR-1, PSR-2, PSR-4, et PSR-7.
Guzzle est conçu pour être léger et rapide, avec très peu de dépendances. Cela signifie que toutes les demandes de fonctionnalités ne seront pas acceptées.
La version minimale de PHP requise pour Guzzle est PHP 7.2. Les demandes de téléchargement ne doivent pas ne doivent pas nécessiter une version de PHP supérieure à PHP 7.2, sauf si la fonction est utilisée utilisée de manière conditionnelle et que le fichier puisse être analysé par PHP 7.2.
Toutes les demandes de retrait doivent inclure des tests unitaires pour s'assurer que le changement fonctionne comme prévu et pour éviter les régressions. comme prévu et pour éviter les régressions.

Exécution des tests ¶

Pour pouvoir contribuer, vous devez récupérer les sources sur GitHub et installer les dépendances de Guzzle à l'aide de Composer :

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

Guzzle est testé en unité avec PHPUnit. Exécutez les tests en utilisant le Makefile :

make test

Note

Vous devez installer node.js v8 ou une version plus récente pour effectuer des tests d'intégration sur les gestionnaires HTTP de Guzzle. d'intégration sur les gestionnaires HTTP de Guzzle.

Signaler une vulnérabilité de sécurité¶

Nous voulons nous assurer que Guzzle est une bibliothèque client HTTP sécurisée pour tout le monde. Si Si vous avez découvert une vulnérabilité de sécurité dans Guzzle, nous apprécions votre aide en nous la divulguant de manière responsable.

La divulgation publique d'une vulnérabilité peut mettre en danger l'ensemble de la communauté. Si vous avez découvert un problème de sécurité, veuillez nous envoyer un courriel à l'adresse suivante security@guzzlephp.org. Nous travaillerons avec vous pour nous assurer que nous comprenons la l'étendue du problème, et que nous répondons entièrement à votre préoccupation. Nous considérons la correspondance envoyée à security@guzzlephp.org comme une priorité absolue et nous nous efforçons de Nous nous efforçons de résoudre les problèmes qui surviennent le plus rapidement possible.

Après la correction d'une vulnérabilité de sécurité, un correctif de sécurité sera déployé dès que possible.

Table des matières