Guzzle PHP 5.3 Documentation

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

摘要

Guzzle 是一个 PHP HTTP 客户端，简化了发送 HTTP 请求和与 Web 服务的集成。它支持同步和异步请求，允许通过可插拔的 HTTP 处理器（如 cURL、PHP 的流包装器等）发送请求。Guzzle 抽象了底层的 HTTP 传输层，不再需要手动处理 cURL 选项、流上下文或套接字。文档详细介绍了如何使用 Guzzle 发送请求、处理响应、配置 SSL 验证、设置超时和流式传输等。此外，还提供了常见问题的解答，如 SSL 验证错误、最大函数嵌套错误和 417 错误响应等。

AI总结

**Guzzle PHP 5.3 文档总结**

**核心观点**
Guzzle 是一个 PHP HTTP 客户端，简化了 HTTP 请求的发送和与 Web 服务的集成。它支持同步和异步请求，无需依赖特定的事件循环，且可通过插件化的 HTTP 处理程序与多种传输方式（如 cURL、sockets、PHP 流包装器等）集成。

**关键功能**
1. **请求管理**：支持持久连接、流式 POST 请求、查询字符串集合等。
2. **同步与异步请求**：使用相同接口发送同步和异步请求。
3. **插件化 HTTP 处理程序**：支持多种传输方式，无需手动配置 cURL 选项或流上下文。
4. **错误处理**：默认抛出 HTTP 协议错误异常，但可通过配置禁用。
5. **调试与流式响应**：支持调试输出和流式响应处理。

**示例代码**

$client = new GuzzleHttp\Client();
$response = $client->get('http://guzzlephp.org');
echo $response->getStatusCode(); // 输出状态码
echo $response->getHeader('content-type'); // 输出响应头
echo $response->getBody(); // 输出响应体

**常见问题与解决方案**
1. **SSL 验证错误**：需指定 CA 证书路径或禁用验证。
2. **函数嵌套错误**：XDebug 扩展导致，可通过修改 `php.ini` 增加嵌套层级限制。
3. **417 错误响应**：服务器不支持 `Expect: 100-Continue` 头部，可通过禁用该头部解决。

**配置选项**
- **timeout**：请求超时时间，默认无限等待。
- **connect_timeout**：连接超时时间，默认无限等待。
- **verify**：SSL 证书验证行为，可启用、禁用或指定 CA 证书路径。
- **debug**：启用调试输出。
- **stream**：启用流式响应处理。

**事件与响应处理**
- **事件系统**：请求对象实现事件发射器接口，可添加事件监听器。
- **响应处理**：支持获取响应状态码、原因短语、协议版本、响应体（JSON、XML 等）。

**安装与依赖**
- **要求**：PHP 5.4.0 及以上，`allow_url_fopen` 启用（使用流处理程序时），cURL >= 7.16.2（使用 cURL 处理程序时）。
- **安装**：推荐使用 Composer 安装，命令为 `php composer.phar require guzzlehttp/guzzle:~5.0`。

**总结**
Guzzle 提供了强大且灵活的 HTTP 客户端功能，简化了 PHP 中的 HTTP 请求处理，支持多种传输方式和配置选项，适合与各种 Web 服务集成。