Resumen

Requisitos

  1. PHP 7.2.5
  2. Para utilizar el gestor de flujos de PHP, allow_url_fopen debe estar habilitado en su php.ini de su sistema.
  3. Para utilizar el manejador cURL, debe tener una versión reciente de cURL >= 7.19.4 compilada con OpenSSL y zlib.

Nota

Guzzle ya no requiere cURL para enviar peticiones HTTP. Guzzle utilizará usará el stream wrapper de PHP para enviar peticiones HTTP si cURL no está instalado. Alternativamente, puedes proporcionar tu propio manejador HTTP para enviar peticiones. Ten en cuenta que cURL sigue siendo necesario para enviar peticiones concurrentes.

Instalación

La forma recomendada de instalar Guzzle es con Composer. Composer es una herramienta de gestión de dependencias para PHP que te permite declarar las dependencias que tu proyecto necesita y las instala en su proyecto.

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

Puedes añadir Guzzle como dependencia utilizando Composer:

composer require guzzlehttp/guzzle:^7.0

Alternativamente, puedes especificar Guzzle como una dependencia en el archivo composer.json de tu proyecto:

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

Después de la instalación, es necesario requerir el autocargador de Composer:

require 'vendor/autoload.php';

Puede encontrar más información sobre cómo instalar Composer, configurar la carga automática y otras buenas prácticas para definir las dependencias en getcomposer.org.

Borde sangrante

Durante tu desarrollo, puedes mantenerte al día con los últimos cambios en la rama maestra estableciendo el requisito de versión para Guzzle a ^7.0@dev.

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

Licencia

Con licencia MIT license.

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

Por el presente documento se autoriza, de forma gratuita, a cualquier persona que obtenga una copia de este software y de los archivos de documentación asociados (el "Software"), para comerciar en el Software sin restricción alguna, incluyendo sin limitación los derechos de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender sublicenciar y/o vender copias del Software, y a permitir que las personas a las que se a las personas a las que se proporcione el Software, con sujeción a las siguientes condiciones:

El anterior aviso de copyright y este aviso de autorización se incluirán en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUIDAS, ENTRE OTRAS, LAS GARANTÍAS DE COMERCIABILIDAD IDONEIDAD PARA UN FIN DETERMINADO Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES LOS AUTORES O LOS TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE CUALQUIER RECLAMACIÓN, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRO TIPO, QUE SURJA DE, O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS OPERACIONES CON EL MISMO. EL SOFTWARE.

Contribuyendo

Directrices

  1. Guzzle utiliza PSR-1, PSR-2, PSR-4 y PSR-7.
  2. Guzzle está pensado para ser ligero y rápido con muy pocas dependencias. Esto significa que que no todas las peticiones de características serán aceptadas.
  3. Guzzle tiene un requisito de versión mínima de PHP 7.2. Las solicitudes de extracción deben requerir una versión de PHP mayor que PHP 7.2 a menos que la característica sea se utilice condicionalmente y el archivo pueda ser analizado por PHP 7.2.
  4. Todos los pull requests deben incluir pruebas unitarias para asegurar que el cambio funciona como como se espera y para evitar regresiones.

Ejecución de las pruebas

Para contribuir, tendrás que obtener el código fuente de GitHub e instalar las dependencias de Guzzle utilizando Composer:

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

Guzzle es probado unitariamente con PHPUnit. Ejecuta las pruebas usando el Makefile:

make test

Nota

Necesitarás instalar node.js v8 o más reciente para poder realizar pruebas de integración en los manejadores HTTP de Guzzle.

Informar de una vulnerabilidad de seguridad

Queremos asegurarnos de que Guzzle es una biblioteca cliente HTTP segura para todos. Si has descubierto una vulnerabilidad de seguridad en Guzzle, agradecemos tu ayuda en revelarla de una manera responsable.

Revelar públicamente una vulnerabilidad puede poner en riesgo a toda la comunidad. Si has descubierto un problema de seguridad, por favor envíanos un correo electrónico a security@guzzlephp.org. Trabajaremos con usted para asegurarnos de que entendemos el alcance del problema, y que abordamos plenamente su preocupación. Consideramos la correspondencia enviada a security@guzzlephp.org nuestra mayor prioridad, y trabajamos para solucionar cualquier problema que surja lo antes posible.

Una vez que se ha corregido una vulnerabilidad de seguridad, se lanzará una revisión de seguridad tan pronto como sea posible.