Panoramica

Requisiti

  1. PHP 7.2.5
  2. Per usare il gestore di flussi PHP, allow_url_fopen deve essere abilitato nel php.ini del sistema.
  3. Per usare il gestore cURL, devi avere una versione recente di cURL >= 7.19.4 compilata con OpenSSL e zlib.

Nota

Guzzle non richiede più cURL per inviare richieste HTTP. Guzzle utilizzerà utilizza il PHP stream wrapper per inviare richieste HTTP se cURL non è installato. In alternativa, potete fornire il vostro gestore HTTP utilizzato per inviare le richieste. Tenete a mente che cURL è ancora richiesto per l'invio di richieste concorrenti.

Installazione

Il modo raccomandato per installare Guzzle è con Composer. Composer è uno strumento di gestione delle dipendenze per PHP che vi permette di dichiarare le dipendenze di cui il vostro progetto ha bisogno e le installa nel vostro progetto.

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

Potete aggiungere Guzzle come dipendenza usando Composer:

composer require guzzlehttp/guzzle:^7.0

In alternativa, potete specificare Guzzle come dipendenza nel file composer.json esistente del vostro progetto:

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

Dopo l'installazione, è necessario richiedere l'autoloader di Composer:

require 'vendor/autoload.php';

Puoi trovare maggiori informazioni su come installare Composer, configurare l'autoloading e altre buone pratiche per definire le dipendenze su getcomposer.org.

Bleeding edge

Durante il vostro sviluppo, potete stare al passo con le ultime modifiche sul ramo master impostando il requisito di versione per Guzzle a ^7.0@dev.

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

Licenza

Concesso in licenza utilizzando la licenza MIT.

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

Con la presente si concede il permesso, gratuitamente, a qualsiasi persona che ottenga una copia di questo software e dei file di documentazione associati (il "Software"), di trattare del Software senza restrizioni, inclusi, senza limitazioni, i diritti utilizzare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e/o vendere copie del Software, e di permettere alle persone a cui il Software viene fornito, soggetto alle seguenti condizioni:

L'avviso di copyright di cui sopra e questo avviso di autorizzazione devono essere inclusi in tutte le copie o porzioni sostanziali del Software.

IL SOFTWARE VIENE FORNITO "COSÌ COM'È", SENZA GARANZIA DI ALCUN TIPO, ESPRESSA O IMPLICITA, INCLUSE MA NON LIMITATE ALLE GARANZIE DI COMMERCIABILITÀ, IDONEITÀ PER UNO SCOPO PARTICOLARE E NON VIOLAZIONE. IN NESSUN CASO GLI AUTORI O I DETENTORI DEL COPYRIGHT SONO RESPONSABILI PER QUALSIASI RECLAMO, DANNO O ALTRA RESPONSABILITÀ, SIA IN UN'AZIONE DI CONTRATTO, TORTO O ALTRO, DERIVANTE DA, DA O IN CONNESSIONE CON IL SOFTWARE O L'USO O ALTRI RAPPORTI CON IL SOFTWARE.

Contribuire

Linee guida

  1. Guzzle utilizza i PSR-1, PSR-2, PSR-4 e PSR-7.
  2. Guzzle è pensato per essere snello e veloce con pochissime dipendenze. Questo significa che non tutte le richieste di funzionalità saranno accettate.
  3. Guzzle ha un requisito minimo di versione PHP di PHP 7.2. Le richieste di pull devono non richiedere una versione di PHP maggiore di PHP 7.2 a meno che la caratteristica sia utilizzata solo in modo condizionale ed il file possa essere analizzato da PHP 7.2.
  4. Tutte le richieste di pull devono includere test unitari per assicurare che la modifica funzioni come previsto e per prevenire regressioni.

Esecuzione dei test

Per poter contribuire, dovrete fare il checkout del sorgente da GitHub e installare le dipendenze di Guzzle usando Composer:

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

Guzzle è testato con PHPUnit. Esegui i test usando il Makefile:

make test

Nota

Avrete bisogno di installare node.js v8 o più recente per eseguire test di integrazione sui gestori HTTP di Guzzle.

Segnalare una vulnerabilità di sicurezza

Vogliamo assicurarci che Guzzle sia una libreria client HTTP sicura per tutti. Se avete scoperto una vulnerabilità di sicurezza in Guzzle, apprezziamo il vostro aiuto nel rivelarcela in modo responsabile.

Divulgare pubblicamente una vulnerabilità può mettere a rischio l'intera comunità. Se hai scoperto un problema di sicurezza, inviaci un'email a security@guzzlephp.org. Lavoreremo con voi per assicurarci di capire la portata del problema, e che affrontiamo pienamente la tua preoccupazione. Consideriamo la corrispondenza inviata a security@guzzlephp.org la nostra massima priorità, e lavoriamo per affrontare qualsiasi problema che si presenta il più rapidamente possibile.

Dopo che una vulnerabilità di sicurezza è stata corretta, un rilascio di un hotfix di sicurezza sarà distribuito il prima possibile.