Guzzle PHP 5.3 Documentation

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

摘要

Guzzle 是一个用于发送 HTTP 请求的 PHP 客户端库，旨在简化与 Web 服务的交互。它遵循 PSR-0、PSR-1 和 PSR-2 标准，具有轻量且快速的特点，依赖项极少。Guzzle 支持同步和异步请求，提供可扩展的处理程序以集成不同的传输方法（如 cURL、PHP 流包装器、套接字等）。文档介绍了如何安装、配置和使用 Guzzle，包括创建客户端、发送请求、处理响应以及使用测试工具 mocking HTTP 层。此外，还详细说明了如何自定义 cURL 选项和流上下文选项。

AI总结

### 《Guzzle PHP 5.3 文档总结》

Guzzle 是一个功能强大的 PHP HTTP 客户端库，旨在简化 HTTP 请求的发送和处理。以下是文档的核心内容和关键信息：

#### 1. **概述**
- **遵循 PSR 标准**：Guzzle 遵循 PSR-0、PSR-1 和 PSR-2 标准，确保代码结构和命名空间的一致性。
- **轻量快速**：Guzzle 设计为轻量级且高效，依赖项极少。
- **最低 PHP 版本要求**：Guzzle 要求 PHP 版本不低于 5.4。
- **依赖管理**：通过 Composer 安装和管理依赖。

#### 2. **HTTP 处理**
- **灵活的传输方式**：Guzzle 使用 RingPHP 处理程序，支持多种 HTTP 传输方式，包括 cURL、PHP 流包装器、套接字和非阻塞事件循环（如 React）。
- **异步请求**：通过设置 `future` 选项，Guzzle 支持异步请求，返回 FutureResponse 对象，支持同步和异步处理。

#### 3. **请求与响应**
- **请求和响应消息**：Guzzle 处理 HTTP 请求和响应消息，支持解析复杂头信息（如 Link 头）。
- **响应处理**：支持获取状态码、头信息和响应体，可将响应体视为流处理。

#### 4. **测试支持**
- **单元测试**：所有代码变更必须包含单元测试，确保功能正常并防止回归错误。
- **模拟工具**：提供 Mock 订阅者和处理程序，便于测试时模拟特定场景，避免依赖外部服务。

#### 5. **配置与扩展**
- **环境变量**：通过环境变量（如 `HTTP_PROXY` 和 `HTTPS_PROXY`）自定义行为。
- **自定义选项**：支持通过 `curl` 和 `stream_context` 配置自定义选项，满足特定需求。

#### 6. **安装与使用**
- **Composer 安装**：使用 Composer 安装 Guzzle，推荐版本为 `~5.0`。
- **快速入门**：创建 `GuzzleHttp\Client` 对象，使用其方法发送 HTTP 请求，处理响应。

#### 7. **常见问题解答**
- **是否需要 cURL？**：Guzzle 默认使用 cURL，但支持其他传输方式。
- **如何处理异步请求？**：通过 `future` 选项发送异步请求，并使用 `then()` 方法处理响应。
- **如何添加自定义选项？**：通过 `config` 请求选项添加 cURL 或流上下文选项。

#### 8. **文档结构**
- 文档分为多个部分，涵盖概述、快速入门、客户端、请求与响应、事件系统、流、RingPHP 处理程序、测试、常见问题解答、HTTP 组件和服务描述命令。

Guzzle 提供了丰富的功能和灵活的配置，适用于各种 HTTP 客户端需求，支持同步和异步请求，适合快速开发和集成到项目中。