'Yii2-Curl-Agent', CURLOPT_TIMEOUT => 30, CURLOPT_CONNECTTIMEOUT => 30, CURLOPT_RETURNTRANSFER => true, CURLOPT_HEADER => false, ); // ############################################### class methods // ############################################## /** * Start performing GET-HTTP-Request * * @param string $url * @param boolean $raw if response body contains JSON and should be decoded * * @return mixed response */ public function get($url, $raw = true) { return $this->_httpRequest('GET', $url, $raw); } /** * Start performing HEAD-HTTP-Request * * @param string $url * * @return mixed response */ public function head($url) { return $this->_httpRequest('HEAD', $url); } /** * Start performing POST-HTTP-Request * * @param string $url * @param boolean $raw if response body contains JSON and should be decoded * * @return mixed response */ public function post($url, $raw = true) { return $this->_httpRequest('POST', $url, $raw); } /** * Start performing PUT-HTTP-Request * * @param string $url * @param boolean $raw if response body contains JSON and should be decoded * * @return mixed response */ public function put($url, $raw = true) { return $this->_httpRequest('PUT', $url, $raw); } /** * Start performing DELETE-HTTP-Request * * @param string $url * @param boolean $raw if response body contains JSON and should be decoded * * @return mixed response */ public function delete($url, $raw = true) { return $this->_httpRequest('DELETE', $url, $raw); } /** * Set curl option * * @param string $key * @param mixed $value * * @return $this */ public function setOption($key, $value) { //set value if (in_array($key, $this->_defaultOptions) && $key !== CURLOPT_WRITEFUNCTION) { $this->_defaultOptions[$key] = $value; } else { $this->_options[$key] = $value; } //return self return $this; } /** * Unset a single curl option * * @param string $key * * @return $this */ public function unsetOption($key) { //reset a single option if its set already if (isset($this->_options[$key])) { unset($this->_options[$key]); } return $this; } /** * Unset all curl option, excluding default options. * * @return $this */ public function unsetOptions() { //reset all options if (isset($this->_options)) { $this->_options = array(); } return $this; } /** * Total reset of options, responses, etc. * * @return $this */ public function reset() { if ($this->_curl !== null) { curl_close($this->_curl); //stop curl } //reset all options if (isset($this->_options)) { $this->_options = array(); } //reset response & status code $this->_curl = null; $this->response = null; $this->responseCode = null; return $this; } /** * Return a single option * * @param string|integer $key * @return mixed|boolean */ public function getOption($key) { //get merged options depends on default and user options $mergesOptions = $this->getOptions(); //return value or false if key is not set. return isset($mergesOptions[$key]) ? $mergesOptions[$key] : false; } /** * Return merged curl options and keep keys! * * @return array */ public function getOptions() { return $this->_options + $this->_defaultOptions; } /** * Get curl info according to http://php.net/manual/de/function.curl-getinfo.php * * @return mixed */ public function getInfo($opt = null) { if ($this->_curl !== null && $opt === null) { return curl_getinfo($this->_curl); } elseif ($this->_curl !== null && $opt !== null) { return curl_getinfo($this->_curl, $opt); } else { return []; } } /** * Performs HTTP request * * @param string $method * @param string $url * @param boolean $raw if response body contains JSON and should be decoded -> helper. * * @throws Exception if request failed * * @return mixed */ private function _httpRequest($method, $url, $raw = false) { //set request type and writer function $this->setOption(CURLOPT_CUSTOMREQUEST, strtoupper($method)); //check if method is head and set no body if ($method === 'HEAD') { $this->setOption(CURLOPT_NOBODY, true); $this->unsetOption(CURLOPT_WRITEFUNCTION); } //setup error reporting and profiling Yii::trace('Start sending cURL-Request: '.$url.'\n', __METHOD__); Yii::beginProfile($method.' '.$url.'#'.md5(serialize($this->getOption(CURLOPT_POSTFIELDS))), __METHOD__); /** * proceed curl */ $this->_curl = curl_init($url); curl_setopt_array($this->_curl, $this->getOptions()); $body = curl_exec($this->_curl); //check if curl was successful if ($body === false) { switch (curl_errno($this->_curl)) { case 7: $this->responseCode = 'timeout'; return false; break; default: throw new Exception('curl request failed: ' . curl_error($this->_curl) , curl_errno($this->_curl)); break; } } //retrieve response code $this->responseCode = curl_getinfo($this->_curl, CURLINFO_HTTP_CODE); $this->response = $body; //end yii debug profile Yii::endProfile($method.' '.$url .'#'.md5(serialize($this->getOption(CURLOPT_POSTFIELDS))), __METHOD__); //check responseCode and return data/status if ($this->getOption(CURLOPT_CUSTOMREQUEST) === 'HEAD') { return true; } else { $this->response = $raw ? $this->response : Json::decode($this->response); return $this->response; } } }