Overview

Requirements

  1. PHP 7.2.5
  2. Para usar o manipulador de fluxo PHP, allow_url_fopen deve ser activado no seu php.ini do sistema.
  3. Para utilizar o manipulador cURL, deve ter uma versão recente do cURL >= 7.19.4 compilada com OpenSSL e zlib.

Nota

O Guzzle já não necessita de cURL para enviar pedidos HTTP. O Guzzle irá utilizar o PHP stream wrapper para enviar pedidos HTTP se o cURL não estiver instalado. Em alternativa, pode fornecer o seu próprio manipulador HTTP utilizado para enviar pedidos. Tenha em mente que a cURL ainda é necessária para o envio de pedidos simultâneos.

Instalação

A forma recomendada para instalar o Guzzle é com Composer. O Composer é uma ferramenta de gestão de dependência para PHP que lhe permite declarar as dependências de que o seu projecto necessita e instala-os no seu projecto.

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

Pode adicionar Guzzle como uma dependência utilizando Composer:

composer require guzzlehttp/guzzle:^7.0

Em alternativa, pode especificar Guzzle como uma dependência no ficheiro composer.json do seu projecto existente:

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

Após a instalação, é necessário requerer o autoloader do Composer:

require 'vendor/autoload.php';

Pode saber mais sobre como instalar o Composer, configurar o auto-carregamento, e outras melhores práticas para definir dependências em getcomposer.org.

Bleeding edge

Durante o seu desenvolvimento, pode acompanhar as últimas alterações no ramo principal, definindo o requisito de versão para Guzzle para ^7.0@dev.

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

Licença

Licenciado utilizando a licença MIT.

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

É concedida autorização, sem custos, a qualquer pessoa que obtenha uma cópia deste software e dos ficheiros de documentação associados (o "Software"), para tratar no Software sem restrições, incluindo sem limitações os direitos utilizar, copiar, modificar, fundir, publicar, distribuir, sublicenciar, e/ou vender cópias do Software, e para permitir às pessoas a quem o Software é mobilado para o fazer, sujeito às seguintes condições:

O aviso de direitos de autor acima e este aviso de permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.

O SOFTWARE É FORNECIDO "TAL COMO ESTÁ", SEM QUALQUER TIPO DE GARANTIA, EXPRESSA OU IMPLÍCITO, INCLUINDO MAS NÃO LIMITADO ÀS GARANTIAS DE COMERCIABILIDADE, APTIDÃO PARA UM DETERMINADO FIM E NÃO-INFRACÇÃO. EM CASO ALGUM O OS AUTORES OU DETENTORES DE DIREITOS DE AUTOR SÃO RESPONSÁVEIS POR QUALQUER RECLAMAÇÃO, DANOS OU OUTROS RESPONSABILIDADE, SEJA NUMA ACÇÃO DE CONTRATO, DELITO CIVIL OU OUTRO, DECORRENTE DE, FORA OU EM LIGAÇÃO COM O SOFTWARE OU A UTILIZAÇÃO OU OUTRAS TRANSACÇÕES EM O SOFTWARE.

Contribuindo

Guidelines

  1. Guzzle utiliza PSR-1, PSR-2, PSR-4, e PSR-7.
  2. O focinho destina-se a ser enxuto e rápido com muito poucas dependências. Isto significa que nem todos os pedidos de recursos serão aceites.
  3. Guzzle tem um requisito mínimo de versão PHP do PHP 7.2. Os pedidos de puxar devem não necessita de uma versão PHP maior que PHP 7.2 a menos que a característica seja apenas utilizado condicionalmente e o ficheiro pode ser analisado pelo PHP 7.2.
  4. Todos os pedidos de puxar devem incluir testes unitários para assegurar que a mudança funciona como esperado e para evitar regressões.

Running the tests

A fim de contribuir, terá de verificar a fonte do GitHub e instalar as dependências do Guzzle usando o Composer:

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

Guzzle é uma unidade testada com PHPUnit. Executar os testes usando o Makefile:

make test

Nota

Terá de instalar o node.js v8 ou mais recente a fim de realizar a integração testes com os manipuladores HTTP da Guzzle.

Relatar uma vulnerabilidade de segurança

Queremos assegurar que Guzzle é uma biblioteca cliente HTTP segura para todos. Se descobriu uma vulnerabilidade de segurança em Guzzle, agradecemos a sua ajuda ao revelá-lo a nós de forma responsável.

A divulgação pública de uma vulnerabilidade pode colocar toda a comunidade em risco. Se descobriu uma preocupação de segurança, por favor envie-nos um e-mail para security@guzzlephp.org. Trabalharemos consigo para nos certificarmos de que compreendemos o âmbito da questão, e que respondemos plenamente à sua preocupação. Consideramos correspondência enviada para security@guzzlephp.org a nossa maior prioridade, e trabalhar para abordar quaisquer questões que surjam o mais rapidamente possível.

Depois de uma vulnerabilidade de segurança ter sido corrigida, uma libertação de hotfixos de segurança será implementada o mais rapidamente possível.