on_headers

摘要

回调函数，当响应的HTTP头信息被接收且主体部分还未开始下载的时候调用。

类型

• callable

常量

GuzzleHttp\RequestOptions::ON_HEADERS

该回调接收 Psr\Http\ResponseInterface 对象。 如果该回调抛出异常，与响应相关的Promise将会接收到 GuzzleHttp\Exception\RequestException 抛出的异常。

在数据写入下游之前，你应该需要知道接收到的头信息与状态码。

// Reject responses that are greater than 1024 bytes.
$client->request('GET', 'http://httpbin.org/stream/1024', [
    'on_headers' => function (ResponseInterface $response) {
        if ($response->getHeaderLine('Content-Length') > 1024) {
            throw new \Exception('The file is too big!');
        }
    }
]);