Guzzle PHP 5.3 Documentation

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

摘要

Guzzle是一个PHP HTTP客户端，简化了HTTP请求的发送和与Web服务的集成。它支持同步和异步请求，抽象了底层的HTTP传输层，并允许通过插件机制与各种HTTP传输方法集成。Guzzle通过Composer进行安装，支持PHP 5.4及以上版本，并提供了丰富的流处理功能，如流装饰器和缓存流。文档详细介绍了Guzzle的安装、使用、事件系统和流处理功能，并提供了代码示例。Guzzle遵循MIT许可证，鼓励社区贡献，并提供安全漏洞报告机制。

AI总结

**Guzzle PHP 5.3 Documentation 总结**

**核心观点：**
Guzzle 是一个功能强大的 PHP HTTP 客户端，简化了 HTTP 请求的发送和与 Web 服务的集成。它支持同步和异步请求，并抽象了底层的 HTTP 传输层，使开发者无需直接处理 cURL 选项、流上下文或套接字。

**关键信息：**

1. **主要特性：**
- 支持同步和异步请求，接口一致，无需依赖特定的事件循环。
- 可插拔的 HTTP 处理器，支持多种传输方式（如 cURL、PHP 流包装器、React 等）。
- 管理持久连接，简化流式 POST 请求的发送，处理查询字符串和文件上传。
- 提供流式数据处理，支持自定义装饰器和事件系统。

2. **安装与依赖：**
- 推荐使用 Composer 安装：`php composer.phar require guzzlehttp/guzzle:~5.0`。
- 最低 PHP 版本要求为 5.4.0，支持 PHP 流处理器和 cURL 处理器（cURL >= 7.16.2）。
- 不强制依赖 cURL，可使用 PHP 流包装器发送请求。

3. **使用示例：**
- 发送同步请求：

     $client = new GuzzleHttp\Client();
     $response = $client->get('http://guzzlephp.org');
     echo $response->getStatusCode(); // 200

- 发送异步请求：

     $req = $client->createRequest('GET', 'http://httpbin.org', ['future' => true]);
     $client->send($req)->then(function ($response) {
         echo 'I completed! ' . $response;
     });

4. **流与元数据：**
- Guzzle 提供流式数据处理，支持读取、写入和元数据获取。
- 示例：`$stream->read(3)` 读取流数据，`$stream->getMetadata('uri')` 获取流元数据。

5. **事件系统与插件：**
- Guzzle 的事件系统允许运行时修改客户端或请求的行为，支持自动重试、日志记录等功能。
- 示例：添加事件监听器，在请求发送前输出请求信息。

6. **安全与贡献：**
- 发现安全漏洞时，可通过 `[e-mail]` 报告。
- 贡献代码需遵循 PSR 标准，包含单元测试，且不引入高于 PHP 5.4 的依赖。

7. **许可证：**
- Guzzle 使用 MIT 许可证，允许自由使用、修改和分发。

**总结：**
Guzzle 是一个灵活且功能丰富的 PHP HTTP 客户端，适用于各种 HTTP 请求场景。它通过抽象底层细节、支持多种传输方式和提供强大的流处理与事件系统，显著简化了与 Web 服务的集成。