RequestOptions

23class RequestOptions extends AbstractDataTransferObject24{25    public const KEY_TIMEOUT = 'timeout';26    public const KEY_CONNECT_TIMEOUT = 'connectTimeout';27    public const KEY_MAX_REDIRECTS = 'maxRedirects';28    /**29     * @var float|null Maximum duration in seconds to wait for the full response.30     */31    protected ?float $timeout = null;32    /**33     * @var float|null Maximum duration in seconds to wait for the initial connection.34     */35    protected ?float $connectTimeout = null;36    /**37     * @var int|null Maximum number of redirects to follow. 0 disables redirects, null is unspecified.38     */39    protected ?int $maxRedirects = null;40    /**41     * Sets the request timeout in seconds.42     *43     * @since 0.2.044     *45     * @param float|null $timeout Timeout in seconds.46     * @return void47     *48     * @throws InvalidArgumentException When timeout is negative.49     */50    public function setTimeout(?float $timeout): void51    {52        $this->validateTimeout($timeout, self::KEY_TIMEOUT);53        $this->timeout = $timeout;54    }55    /**56     * Sets the connection timeout in seconds.57     *58     * @since 0.2.059     *60     * @param float|null $timeout Connection timeout in seconds.61     * @return void62     *63     * @throws InvalidArgumentException When timeout is negative.64     */65    public function setConnectTimeout(?float $timeout): void66    {67        $this->validateTimeout($timeout, self::KEY_CONNECT_TIMEOUT);68        $this->connectTimeout = $timeout;69    }70    /**71     * Sets the maximum number of redirects to follow.72     *73     * Set to 0 to disable redirects, null for unspecified, or a positive integer74     * to enable redirects with a maximum count.75     *76     * @since 0.2.077     *78     * @param int|null $maxRedirects Maximum redirects to follow, or 0 to disable, or null for unspecified.79     * @return void80     *81     * @throws InvalidArgumentException When redirect count is negative.82     */83    public function setMaxRedirects(?int $maxRedirects): void84    {85        if ($maxRedirects !== null && $maxRedirects < 0) {86            throw new InvalidArgumentException('Request option "maxRedirects" must be greater than or equal to 0.');87        }88        $this->maxRedirects = $maxRedirects;89    }90    /**91     * Gets the request timeout in seconds.92     *93     * @since 0.2.094     *95     * @return float|null Timeout in seconds.96     */97    public function getTimeout(): ?float98    {99        return $this->timeout;100    }101    /**102     * Gets the connection timeout in seconds.