spindle / spindle-httpclient

src/Request.php

<?php
/**
 * spindle/httpclient
 * @license CC0-1.0 (Public Domain) https://creativecommons.org/publicdomain/zero/1.0/
 * @see https://github.com/spindle/spindle-httpclient
 */
namespace Spindle\HttpClient;

class Request
{
    private $responseClass = '\Spindle\HttpClient\Response';
    private $handle;

    protected $options = array(
        'returnTransfer' => true,
        'header' => true,
    );

    protected $response;

    protected $error;

    function __construct($url = null, array $options = array()) {

It is generally recommended to explicitly declare the visibility for methods.

        if (is_string($url)) {
            $this->handle = curl_init($url);
            $options['url'] = $url;
        } else {
            $this->handle = curl_init();
        }

        $this->options += $options;
        $this->setOptions($this->options);
    }

    function __destruct() {

It is generally recommended to explicitly declare the visibility for methods.

        curl_close($this->handle);
    }

    function __clone() {

It is generally recommended to explicitly declare the visibility for methods.

        $this->handle = curl_copy_handle($this->handle);
    }

    function setOptions(array $options) {

It is generally recommended to explicitly declare the visibility for methods.

        $this->options = $options + $this->options;
        curl_setopt_array($this->handle, $this->_toCurlSetopt($options));
        return $this;
    }

    function setOption($label, $val) {

It is generally recommended to explicitly declare the visibility for methods.

        $this->options[$label] = $val;
        curl_setopt($this->handle, $this->_toCurlOption($label), $val);
        return $this;
    }

    function getOption($label) {

It is generally recommended to explicitly declare the visibility for methods.

        return $this->options[$label];
    }

    function getOptions() {

It is generally recommended to explicitly declare the visibility for methods.

        return $this->options;
    }

    function getHandle()

It is generally recommended to explicitly declare the visibility for methods.

    {
        return $this->handle;
    }

    /**
     *
     * @throws CurlException
     */
    function send() {

It is generally recommended to explicitly declare the visibility for methods.

        $body = curl_exec($this->handle);
        $info = curl_getinfo($this->handle);
        $this->response = $res = new $this->responseClass($body, $info);

        $errno = curl_errno($this->handle);
        if (0 !== $errno) {
            $err = new CurlException(curl_error($this->handle), $errno);
            $err->setRequest($this);
            $this->error = $err;
            throw $err;
        }
        return $res;
    }

    function setResponse($res) {

It is generally recommended to explicitly declare the visibility for methods.

        $this->response = $res;
    }

    function getResponse() {

It is generally recommended to explicitly declare the visibility for methods.

        return $this->response;
    }

    function setError(CurlException $err) {

It is generally recommended to explicitly declare the visibility for methods.

        $this->error = $err;
    }

    function getError() {

It is generally recommended to explicitly declare the visibility for methods.

        return $this->error;
    }

    protected function _toCurlSetopt(array $optionList) {
        $fixedOptionList = array();
        foreach ($optionList as $opt => $value) {
            $label = $this->_toCurlOption($opt);
            $fixedOptionList[$label] = $value;
        }
        return $fixedOptionList;
    }

    protected function _toCurlOption($label) {
        if (is_int($label)) {
            return $label;
        }

        if (is_string($label)) {
            $const = 'CURLOPT_' . strtoupper($label);
            if (defined($const)) {
                $curlopt = constant($const);
            } else {
                throw new \InvalidArgumentException("$label does not exist in CURLOPT_* constants.");
            }
            return $curlopt;
        }

        throw new \InvalidArgumentException('label is invalid');
    }
}