Guzzle PHP 5.3 Documentation

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

摘要

Guzzle is a PHP HTTP client designed to simplify sending HTTP requests and integrating with web services. It supports both synchronous and asynchronous requests, manages persistent connections, and abstracts the underlying HTTP transport layer. Guzzle is lightweight, fast, and follows PSR-0, PSR-1, and PSR-2 standards. It allows for pluggable HTTP handlers, stream manipulation, and event-driven customization of requests and responses.

AI总结

Guzzle 是一个功能强大的 PHP HTTP 客户端，旨在简化 HTTP 请求的发送和与网络服务的集成。以下是文档的核心内容总结：

### 核心功能
1. **HTTP 请求管理**：
- 支持同步和异步请求，使用相同接口，无需依赖特定事件循环。
- 简化 POST 请求，支持流式传输和文件上传。
- 抽象底层 HTTP 传输层，隐藏 cURL、套接字等实现细节。

2. **可插拔的 HTTP 处理器**：
- 支持多种传输方式，如 cURL、PHP 流包装器、非阻塞事件循环（如 React）等。
- 允许通过自定义处理器扩展功能。

3. **响应处理**：
- 提供统一的响应对象，支持获取状态码、头信息、正文内容等。
- 支持 JSON 解析、内容解码和流式处理。

4. **灵活性与可扩展性**：
- 支持自定义事件处理和插件扩展，允许动态修改客户端或请求行为。
- 提供灵活的配置选项，如默认选项、事件订阅和基础 URL。

### 安装与使用
- **安装**：推荐使用 Composer，命令为 `php composer.phar require guzzlehttp/guzzle:~5.0`。
- **快速上手**：

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

### 其他重要信息
1. **依赖与版本要求**：
- 最低 PHP 版本为 5.4.0。
- 无需强制依赖 cURL，但推荐安装以提高性能。

2. **RingPHP 处理器**：
- 使用 RingPHP 集成不同传输方式，如 React，实现灵活的 HTTP 请求处理。

3. **事件系统**：
- 支持自定义事件处理，允许在请求生命周期中动态修改行为。

4. **许可证**：
- 采用 MIT 许可证，允许自由使用和修改。

### 总结
Guzzle 通过简洁易用的接口和强大的扩展性，帮助开发者高效处理 HTTP 请求和集成网络服务。其灵活的传输方式、事件系统和流式处理能力使其成为 PHP 开发中的重要工具。