Download the PHP package php-packagist/rocket without Composer
On this page you can find all versions of the php package php-packagist/rocket. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package rocket
PHP HTTP 客户端
该扩展基于 Laravel 的 illuminate/http 扩展进行简化独立而得,主要为兼容 PHP5.3。核心源码更多为官方源码。
安装
使用
使用文档,拷贝官方的,:sweat_smile: :sweat_smile:
创建请求
你可以通过 get、 post、 put、 patch 和 delete 方法来创建请求。首先,让我们先看一下如何发出一个基础的 GET 请求:
get 方法返回一个 PhpPackagist\Rocket\Response 的实例,该实例提供了大量的方法来检查请求的响应:
PhpPackagist\Rocket\Response 对象同样实现了 PHP 的 ArrayAccess 接口,这代表着你可以直接访问响应的 JSON 数据。
请求数据
大多数情况下,POST、 PUT 和 PATCH 携带着额外的请求数据是相当常见的。所以,这些方法的第二个参数接受一个包含着请求数据的数组。默认情况下,这些数据会使用 application/json 类型随请求发送。
发送 URL 编码的请求
如果你希望使用 application/x-www-form-urlencoded 作为请求的数据类型,你可以在创建请求前调用 asForm 方法:
发送 Multipart 请求
如果你希望将文件作为 Multipart 请求发送,你应该在创建请求前调用 attach 方法。该方法接受文件的标识符(相当于 HTML Input 的 name 属性)以及其内容。你也可以在第三个参数传入自定义的文件名称,这不是必须的。
除了传递文件的原始内容,你也可以传递 Stream 流数据:
请求头
你可以通过 withHeaders 方法添加请求头。该方法接受一个数组格式的键值对。
认证
你可以使用 withBasicAuth 和 withDigestAuth 方法来分别指定使用 basic 或是 digest 认证方式:
Bearer Token(Token 令牌)
如果你想要为你的请求快速添加 Authorization Token 令牌请求头,你可以使用 withToken 方法:
重试
如果你希望你的 HTTP 客户端在发生错误时自动重新发送请求,你可以使用 retry 方法。该方法接受两个参数:重新尝试次数以及重试等待时间(毫秒):
如果所有的请求都失败了,PhpPackagist\Rocket\RequestException 异常将会被抛出。
错误处理
跟 Guzzle 的默认行为不同,Laravel HTTP 客户端并不会在客户端或服务端错误时抛出异常(400 及 500 状态码)。你可以通过 successful、 clientError 或是 serverError 方法来判断是否发生错误:
抛出异常
如果你希望请求在发生客户端或服务端错误时抛出 PhpPackagist\Rocket\RequestException 异常,你可以在请求实例上调用 throw 方法:
PhpPackagist\Rocket\RequestException 实例拥有一个 $response 公共属性,该属性允许你检查返回的响应。
如果没有发生错误,throw 方法将返回响应实例,你可以在其上进行其他操作:
LICENSE
MIT
All versions of rocket with dependencies
guzzlehttp/guzzle Version ^3.8
ext-json Version *
psr/http-message Version ^1.0