Fix phpdoc
[GitHub/WoltLab/WCF.git] / wcfsetup / install / files / lib / system / api / guzzlehttp / guzzle / src / Handler / CurlHandler.php
1 <?php
2
3 namespace GuzzleHttp\Handler;
4
5 use GuzzleHttp\Promise\PromiseInterface;
6 use Psr\Http\Message\RequestInterface;
7
8 /**
9 * HTTP handler that uses cURL easy handles as a transport layer.
10 *
11 * When using the CurlHandler, custom curl options can be specified as an
12 * associative array of curl option constants mapping to values in the
13 * **curl** key of the "client" key of the request.
14 *
15 * @final
16 */
17 class CurlHandler
18 {
19 /**
20 * @var CurlFactoryInterface
21 */
22 private $factory;
23
24 /**
25 * Accepts an associative array of options:
26 *
27 * - handle_factory: Optional curl factory used to create cURL handles.
28 *
29 * @param array{handle_factory?: ?CurlFactoryInterface} $options Array of options to use with the handler
30 */
31 public function __construct(array $options = [])
32 {
33 $this->factory = $options['handle_factory']
34 ?? new CurlFactory(3);
35 }
36
37 public function __invoke(RequestInterface $request, array $options): PromiseInterface
38 {
39 if (isset($options['delay'])) {
40 \usleep($options['delay'] * 1000);
41 }
42
43 $easy = $this->factory->create($request, $options);
44 \curl_exec($easy->handle);
45 $easy->errno = \curl_errno($easy->handle);
46
47 return CurlFactory::finish($this, $easy, $this->factory);
48 }
49 }