Guzzle PHP 5.3 Documentation

**Guzzle PHP 5.3 文档总结** **核心观点** Guzzle 是一个 PHP HTTP 客户端，简化了 HTTP 请求的发送和与 Web 服务的集成。它支持同步和异步请求，无需依赖特定的事件循环，且可通过插件化的 HTTP 处理程序与多种传输方式（如 cURL、sockets、PHP 流包装器等）集成。 **关键功能** 1. **请求管理**：支持持久连接、流式 POST 请求、查询字符串集合等。 2. **同步与异步请求**：使用相同接口发送同步和异步请求。 3. **插件化 HTTP 处理程序**：支持多种传输方式，无需手动配置 cURL 选项或流上下文。 4. **错误处理**：默认抛出 HTTP 协议错误异常，但可通过配置禁用。 5. **调试与流式响应**：支持调试输出和流式响应处理。 **示例代码** ```php $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 服务集成。