Guzzle PHP 6.5 Documentation

语言	格式	评分
英语	.pdf	3
摘要
《Guzzle PHP 6.5 Documentation》提供了Guzzle的全面指南，包括安装、配置、使用方法及最佳实践。文档详细介绍了如何使用Guzzle发送HTTP请求、处理响应，以及如何配置各种请求选项。内容涵盖依赖管理、许可证、贡献指南、环境变量设置、异常处理、请求选项和PSR-7接口的使用。文档还提供了快速入门示例和常见问题解答。
AI总结
《Guzzle PHP 6.5 Documentation》提供了Guzzle HTTP客户端的安装、配置、使用和开发指南。以下是文档的核心内容总结： --- ### 1. 安装与配置 - 安装方式：推荐使用Composer安装Guzzle，支持版本`~6.0`。 ```bash php composer.phar require guzzlehttp/guzzle:~6.0 ``` - 自动加载：通过Composer的`vendor/autoload.php`加载Guzzle类。 ### 2. 开发与贡献 - 代码规范：遵循PSR-1、PSR-2、PSR-4和PSR-7规范。 - 依赖管理：保持轻量，避免过多依赖。 - 版本要求：最低支持PHP 5.5。 - 测试要求：所有提交的Pull Request必须包含单元测试。 ### 3. 快速入门 #### 3.1 创建客户端 ```php use GuzzleHttp\Client; $client = new Client([ 'base_uri' => 'http://httpbin.org', 'timeout' => 2.0 ]); ``` #### 3.2 发送请求 ```php $response = $client->request('GET', 'test'); ``` #### 3.3 异常处理 - 请求异常：`GuzzleHttp\Exception\RequestException`（包括`ConnectException`、`ClientException`、`ServerException`、`TooManyRedirectsException`）。 - 错误处理：通过`http_errors`选项控制4xx和5xx错误的处理方式。 #### 3.4 环境变量与配置 - `GUZZLE_curl_SELECT_TIMEOUT`：控制cURL多线程超时。 - `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY`：定义代理设置。 - `openssl.cafile`：指定SSL证书路径。 ### 4. 请求选项 - 认证：通过`auth`选项设置HTTP认证。 - 超时：`connect_timeout`和`read_timeout`控制连接和读取超时。 - 证书：通过`cert`选项指定客户端证书。 - Cookie管理：使用`cookies`选项控制Cookie行为。 - 异步请求：通过`sendAsync`方法实现异步请求。 ### 5. PSR-7兼容性 - 使用PSR-7接口定义请求、响应和流，便于与其他兼容库集成。 ### 6. 测试与调试 - 测试工具：使用`Mock Handler`和`History Middleware`模拟和记录请求。 - 测试服务器：提供一个内置的测试Web服务器。 ### 7. 常见问题 - 是否需要cURL？：Guzzle默认使用PHP stream wrapper，cURL是可选的。 - 如何处理SSL错误？：通过`verify`选项控制SSL验证。 - 如何跟踪重定向？：使用`allow_redirects`选项控制重定向行为。 --- ### 总结 Guzzle是一个功能强大的PHP HTTP客户端，支持同步和异步请求，兼容PSR-7接口，提供灵活的配置和扩展能力。文档详细介绍了安装、配置、使用和开发指南，适合开发者快速上手和深入集成。