概述

要求

  1. PHP 7.2.5
  2. 要使用PHP流处理器,allow_url_fopen 必须在你的 系统的php.ini中启用。
  3. 要使用cURL处理程序,你必须有一个最新版本的cURL >= 7.19.4 编译的OpenSSL和zlib。

注意事项

Guzzle不再需要cURL来发送HTTP请求。如果没有安装cURL,Guzzle将 会使用PHP流包装器来发送HTTP请求,如果没有安装cURL的话。 另外,你也可以提供你自己的HTTP处理程序来发送请求。 请记住,在发送并发请求时仍然需要cURL。

安装

安装Guzzle的推荐方式是使用 Composer。Composer是一个依赖性管理工具 它允许你声明你的项目所需的依赖性,并将它们安装到你的项目中。 将它们安装到你的项目中。

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

你可以使用Composer将Guzzle作为一个依赖项加入。

composer require guzzlehttp/guzzle:^7.0

另外,你也可以在你项目现有的composer.json文件中指定Guzzle为依赖项。

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

安装后,你需要要求Composer的自动加载器。

require 'vendor/autoload.php';

你可以在getcomposer.org找到更多关于如何安装Composer、配置自动加载以及其他定义依赖关系的最佳做法。

出血的边缘

在你的开发过程中,你可以通过将Guzzle的版本要求设置为^7.0@dev来跟上主分支的最新变化。

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

许可证

许可使用MIT许可

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

特此允许任何获得本软件及相关文档文件("软件")副本的人免费处理。 本软件和相关文档文件("软件")的副本,可以不受限制地处理本软件。 本软件,包括但不限于以下权利 使用、复制、修改、合并、出版、分发、分许可和/或销售本软件的副本,并允许其使用本软件。 软件的副本,并允许接受软件的人这样做。 并允许接受软件的人这样做,但须符合以下条件。

上述版权声明和本许可声明应包括在本软件的所有副本或实质部分中。

本软件是按 "原样 "提供的,没有任何形式的明示或暗示的保证。 暗示的保证,包括但不限于对适销性的保证。 适用于某一特定目的和不侵权的保证。在任何情况下 作者或版权持有人在任何情况下都不对任何索赔、损害或其他责任负责。 责任,无论是在合同、侵权行为或其他方面的诉讼中,由以下原因引起。 引起的,或与本软件有关的,或与本软件的使用或其他交易有关的任何索赔、损害赔偿或其他责任,作者或版权持有人均不承担任何责任。 本软件。

贡献

准则

  1. Guzzle使用了PSR-1、PSR-2、PSR-4和PSR-7。
  2. Guzzle的目的是精简和快速,依赖性很低。这意味着 不是每一个功能请求都会被接受。
  3. Guzzle的最低PHP版本要求为PHP7.2。拉动请求必须 除非该功能只是有条件的使用,并且文件可以被 PHP 7.2 解析,否则拉动请求不能要求超过 PHP 7.2 的版本。 使用,并且文件可以由 PHP 7.2 解析。
  4. 所有的拉动请求都必须包括单元测试,以确保变化能按预期进行。 以防止退步。

运行测试

为了做出贡献,你需要从GitHub上签出源代码,并使用Composer安装Guzzle的依赖项。

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

Guzzle是用PHPUnit进行单元测试的。使用Makefile来运行测试。

make test

注意事项

你需要安装node.js v8或更新的版本,以便对Guzzle的HTTP处理程序进行集成测试。 对Guzzle的HTTP处理程序进行集成测试。

报告安全漏洞

我们想确保Guzzle是一个对所有人都安全的HTTP客户端库。如果 如果你发现了Guzzle的安全漏洞,我们非常感谢你的帮助 以一种负责任的方式向我们披露它。

公开披露一个漏洞会使整个社区处于危险之中。如果 你发现了一个安全问题,请发邮件给我们 security@guzzlephporg。我们将与你一起工作,以确保我们了解问题的范围。 问题的范围,并确保我们完全解决你的问题。我们认为 发送给security@guzzlephp.org的信件是我们最优先考虑的,并致力于 尽快解决任何出现的问题。

在安全漏洞得到纠正后,将尽快部署安全热补丁版本。