1<?php
2
3namespace GuzzleHttp\Handler;
4
5use GuzzleHttp\Promise\PromiseInterface;
6use 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 */
17class 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}
50