Guzzle PHP 7.0 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: docs.guzzlephp.org

摘要

The document provides an overview of the Guzzle HTTP client library for PHP 7.0, covering installation, configuration, and usage. It details how to make requests, handle responses, configure options, and manage exceptions. The guide also includes information on dependencies, testing, and contributing to the project, along with frequently asked questions about using Guzzle.

AI总结

《Guzzle PHP 7.0 Documentation》提供了Guzzle HTTP客户端库的详细指南，以下是文档的核心内容总结：

### 1. 项目概述
- **许可证**：采用MIT License，允许自由使用、修改和分发。
- **贡献指南**：
- 遵循PSR-1、PSR-2、PSR-4和PSR-7规范。
- 保持轻量和快速，避免过多依赖。
- 最低PHP版本要求为7.2。
- 提交代码需包含单元测试。

### 2. 安装与配置
- **推荐安装方式**：使用Composer安装。

  composer require guzzlehttp/guzzle:^7.0

- 配置自动加载：在项目中引入`vendor/autoload.php`。

### 3. 快速入门
- **创建客户端**：

  use GuzzleHttp\Client;
  $client = new Client([
      'base_uri' => 'http://httpbin.org',
      'timeout' => 2.0
  ]);

- **发送请求**：

  $response = $client->request('GET', '/test');

### 4. 异常处理
- **主要异常类型**：
- `TransferException`：所有传输异常的父类。
- `RequestException`：请求过程中发生的异常。
- `ConnectException`：网络连接错误。
- `ClientException`：400级错误（当`http_errors`选项启用时）。
- `ServerException`：500级错误（当`http_errors`选项启用时）。
- `TooManyRedirectsException`：重定向次数过多。

### 5. 环境变量与配置
- **环境变量**：
- `GUZZLE_curl_SELECT_TIMEOUT`：控制`curl_multi_*`的超时时间。
- `HTTP_PROXY`和`HTTPS_PROXY`：定义HTTP和HTTPS代理。
- `NO_PROXY`：指定不使用代理的URL。
- **请求选项**：支持多种自定义选项，如`allow_redirects`、`auth`、`body`、`proxy`等。

### 6. 常见问题解答（FAQ）
- **是否需要cURL？**：Guzzle默认使用cURL，但也可配置其他HTTP处理程序（如PHP流或自定义实现）。
- **支持异步请求？**：支持异步请求，通过`requestAsync`等方法返回Promise对象。
- **如何添加自定义cURL选项？**：通过`curl`请求选项或`CurlMultiHandler`的选项配置。

### 7. 测试与安全
- **测试**：使用PHPUnit进行单元测试，集成测试需Node.js v8或更高版本。
- **安全漏洞报告**：通过`[e-mail]`邮件地址报告安全问题。

### 8. 其他功能
- **代理支持**：通过`proxy`选项和环境变量配置代理。
- **SSL验证**：通过`verify`选项控制SSL证书验证。
- **日志与调试**：通过`debug`选项启用调试模式。

### 总结
Guzzle是一个功能强大且灵活的HTTP客户端库，支持多种协议、代理、自定义选项和异步请求，适合需要高性能和可定制化的HTTP客户端场景。