2
0

Curl.php 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506
  1. <?php
  2. /**
  3. * Zend Framework
  4. *
  5. * LICENSE
  6. *
  7. * This source file is subject to the new BSD license that is bundled
  8. * with this package in the file LICENSE.txt.
  9. * It is also available through the world-wide-web at this URL:
  10. * http://framework.zend.com/license/new-bsd
  11. * If you did not receive a copy of the license and are unable to
  12. * obtain it through the world-wide-web, please send an email
  13. * to license@zend.com so we can send you a copy immediately.
  14. *
  15. * @category Zend
  16. * @package Zend_Http
  17. * @subpackage Client_Adapter
  18. * @version $Id$
  19. * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  20. * @license http://framework.zend.com/license/new-bsd New BSD License
  21. */
  22. /**
  23. * @see Zend_Uri_Http
  24. */
  25. require_once 'Zend/Uri/Http.php';
  26. /**
  27. * @see Zend_Http_Client_Adapter_Interface
  28. */
  29. require_once 'Zend/Http/Client/Adapter/Interface.php';
  30. /**
  31. * @see Zend_Http_Client_Adapter_Stream
  32. */
  33. require_once 'Zend/Http/Client/Adapter/Stream.php';
  34. /**
  35. * An adapter class for Zend_Http_Client based on the curl extension.
  36. * Curl requires libcurl. See for full requirements the PHP manual: http://php.net/curl
  37. *
  38. * @category Zend
  39. * @package Zend_Http
  40. * @subpackage Client_Adapter
  41. * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  42. * @license http://framework.zend.com/license/new-bsd New BSD License
  43. */
  44. class Zend_Http_Client_Adapter_Curl implements Zend_Http_Client_Adapter_Interface, Zend_Http_Client_Adapter_Stream
  45. {
  46. /**
  47. * Parameters array
  48. *
  49. * @var array
  50. */
  51. protected $_config = array();
  52. /**
  53. * What host/port are we connected to?
  54. *
  55. * @var array
  56. */
  57. protected $_connected_to = array(null, null);
  58. /**
  59. * The curl session handle
  60. *
  61. * @var resource|null
  62. */
  63. protected $_curl = null;
  64. /**
  65. * List of cURL options that should never be overwritten
  66. *
  67. * @var array
  68. */
  69. protected $_invalidOverwritableCurlOptions = array(
  70. CURLOPT_HTTPGET,
  71. CURLOPT_POST,
  72. CURLOPT_PUT,
  73. CURLOPT_CUSTOMREQUEST,
  74. CURLOPT_HEADER,
  75. CURLOPT_RETURNTRANSFER,
  76. CURLOPT_HTTPHEADER,
  77. CURLOPT_POSTFIELDS,
  78. CURLOPT_INFILE,
  79. CURLOPT_INFILESIZE,
  80. CURLOPT_PORT,
  81. CURLOPT_MAXREDIRS,
  82. CURLOPT_CONNECTTIMEOUT,
  83. CURL_HTTP_VERSION_1_1,
  84. CURL_HTTP_VERSION_1_0,
  85. );
  86. /**
  87. * Response gotten from server
  88. *
  89. * @var string
  90. */
  91. protected $_response = null;
  92. /**
  93. * Stream for storing output
  94. *
  95. * @var resource
  96. */
  97. protected $out_stream;
  98. /**
  99. * Adapter constructor
  100. *
  101. * Config is set using setConfig()
  102. *
  103. * @return void
  104. * @throws Zend_Http_Client_Adapter_Exception
  105. */
  106. public function __construct()
  107. {
  108. if (!extension_loaded('curl')) {
  109. require_once 'Zend/Http/Client/Adapter/Exception.php';
  110. throw new Zend_Http_Client_Adapter_Exception('cURL extension has to be loaded to use this Zend_Http_Client adapter.');
  111. }
  112. }
  113. /**
  114. * Set the configuration array for the adapter
  115. *
  116. * @throws Zend_Http_Client_Adapter_Exception
  117. * @param Zend_Config | array $config
  118. * @return Zend_Http_Client_Adapter_Curl
  119. */
  120. public function setConfig($config = array())
  121. {
  122. if ($config instanceof Zend_Config) {
  123. $config = $config->toArray();
  124. } elseif (! is_array($config)) {
  125. require_once 'Zend/Http/Client/Adapter/Exception.php';
  126. throw new Zend_Http_Client_Adapter_Exception(
  127. 'Array or Zend_Config object expected, got ' . gettype($config)
  128. );
  129. }
  130. if(isset($config['proxy_user']) && isset($config['proxy_pass'])) {
  131. $this->setCurlOption(CURLOPT_PROXYUSERPWD, $config['proxy_user'].":".$config['proxy_pass']);
  132. unset($config['proxy_user'], $config['proxy_pass']);
  133. }
  134. foreach ($config as $k => $v) {
  135. $option = strtolower($k);
  136. switch($option) {
  137. case 'proxy_host':
  138. $this->setCurlOption(CURLOPT_PROXY, $v);
  139. break;
  140. case 'proxy_port':
  141. $this->setCurlOption(CURLOPT_PROXYPORT, $v);
  142. break;
  143. default:
  144. $this->_config[$option] = $v;
  145. break;
  146. }
  147. }
  148. return $this;
  149. }
  150. /**
  151. * Retrieve the array of all configuration options
  152. *
  153. * @return array
  154. */
  155. public function getConfig()
  156. {
  157. return $this->_config;
  158. }
  159. /**
  160. * Direct setter for cURL adapter related options.
  161. *
  162. * @param string|int $option
  163. * @param mixed $value
  164. * @return Zend_Http_Adapter_Curl
  165. */
  166. public function setCurlOption($option, $value)
  167. {
  168. if (!isset($this->_config['curloptions'])) {
  169. $this->_config['curloptions'] = array();
  170. }
  171. $this->_config['curloptions'][$option] = $value;
  172. return $this;
  173. }
  174. /**
  175. * Initialize curl
  176. *
  177. * @param string $host
  178. * @param int $port
  179. * @param boolean $secure
  180. * @return void
  181. * @throws Zend_Http_Client_Adapter_Exception if unable to connect
  182. */
  183. public function connect($host, $port = 80, $secure = false)
  184. {
  185. // If we're already connected, disconnect first
  186. if ($this->_curl) {
  187. $this->close();
  188. }
  189. // If we are connected to a different server or port, disconnect first
  190. if ($this->_curl
  191. && is_array($this->_connected_to)
  192. && ($this->_connected_to[0] != $host
  193. || $this->_connected_to[1] != $port)
  194. ) {
  195. $this->close();
  196. }
  197. // Do the actual connection
  198. $this->_curl = curl_init();
  199. if ($port != 80) {
  200. curl_setopt($this->_curl, CURLOPT_PORT, intval($port));
  201. }
  202. // Set timeout
  203. curl_setopt($this->_curl, CURLOPT_CONNECTTIMEOUT, $this->_config['timeout']);
  204. // Set Max redirects
  205. curl_setopt($this->_curl, CURLOPT_MAXREDIRS, $this->_config['maxredirects']);
  206. if (!$this->_curl) {
  207. $this->close();
  208. require_once 'Zend/Http/Client/Adapter/Exception.php';
  209. throw new Zend_Http_Client_Adapter_Exception('Unable to Connect to ' . $host . ':' . $port);
  210. }
  211. if ($secure !== false) {
  212. // Behave the same like Zend_Http_Adapter_Socket on SSL options.
  213. if (isset($this->_config['sslcert'])) {
  214. curl_setopt($this->_curl, CURLOPT_SSLCERT, $this->_config['sslcert']);
  215. }
  216. if (isset($this->_config['sslpassphrase'])) {
  217. curl_setopt($this->_curl, CURLOPT_SSLCERTPASSWD, $this->_config['sslpassphrase']);
  218. }
  219. }
  220. // Update connected_to
  221. $this->_connected_to = array($host, $port);
  222. }
  223. /**
  224. * Send request to the remote server
  225. *
  226. * @param string $method
  227. * @param Zend_Uri_Http $uri
  228. * @param float $http_ver
  229. * @param array $headers
  230. * @param string $body
  231. * @return string $request
  232. * @throws Zend_Http_Client_Adapter_Exception If connection fails, connected to wrong host, no PUT file defined, unsupported method, or unsupported cURL option
  233. */
  234. public function write($method, $uri, $httpVersion = 1.1, $headers = array(), $body = '')
  235. {
  236. // Make sure we're properly connected
  237. if (!$this->_curl) {
  238. require_once 'Zend/Http/Client/Adapter/Exception.php';
  239. throw new Zend_Http_Client_Adapter_Exception("Trying to write but we are not connected");
  240. }
  241. if ($this->_connected_to[0] != $uri->getHost() || $this->_connected_to[1] != $uri->getPort()) {
  242. require_once 'Zend/Http/Client/Adapter/Exception.php';
  243. throw new Zend_Http_Client_Adapter_Exception("Trying to write but we are connected to the wrong host");
  244. }
  245. // set URL
  246. curl_setopt($this->_curl, CURLOPT_URL, $uri->__toString());
  247. // ensure correct curl call
  248. $curlValue = true;
  249. switch ($method) {
  250. case Zend_Http_Client::GET:
  251. $curlMethod = CURLOPT_HTTPGET;
  252. break;
  253. case Zend_Http_Client::POST:
  254. $curlMethod = CURLOPT_POST;
  255. break;
  256. case Zend_Http_Client::PUT:
  257. // There are two different types of PUT request, either a Raw Data string has been set
  258. // or CURLOPT_INFILE and CURLOPT_INFILESIZE are used.
  259. if(is_resource($body)) {
  260. $this->_config['curloptions'][CURLOPT_INFILE] = $body;
  261. }
  262. if (isset($this->_config['curloptions'][CURLOPT_INFILE])) {
  263. // Now we will probably already have Content-Length set, so that we have to delete it
  264. // from $headers at this point:
  265. foreach ($headers AS $k => $header) {
  266. if (preg_match('/Content-Length:\s*(\d+)/i', $header, $m)) {
  267. if(is_resource($body)) {
  268. $this->_config['curloptions'][CURLOPT_INFILESIZE] = (int)$m[1];
  269. }
  270. unset($headers[$k]);
  271. }
  272. }
  273. if (!isset($this->_config['curloptions'][CURLOPT_INFILESIZE])) {
  274. require_once 'Zend/Http/Client/Adapter/Exception.php';
  275. throw new Zend_Http_Client_Adapter_Exception("Cannot set a file-handle for cURL option CURLOPT_INFILE without also setting its size in CURLOPT_INFILESIZE.");
  276. }
  277. if(is_resource($body)) {
  278. $body = '';
  279. }
  280. $curlMethod = CURLOPT_PUT;
  281. } else {
  282. $curlMethod = CURLOPT_CUSTOMREQUEST;
  283. $curlValue = "PUT";
  284. }
  285. break;
  286. case Zend_Http_Client::DELETE:
  287. $curlMethod = CURLOPT_CUSTOMREQUEST;
  288. $curlValue = "DELETE";
  289. break;
  290. case Zend_Http_Client::OPTIONS:
  291. $curlMethod = CURLOPT_CUSTOMREQUEST;
  292. $curlValue = "OPTIONS";
  293. break;
  294. case Zend_Http_Client::TRACE:
  295. $curlMethod = CURLOPT_CUSTOMREQUEST;
  296. $curlValue = "TRACE";
  297. break;
  298. case Zend_Http_Client::HEAD:
  299. $curlMethod = CURLOPT_CUSTOMREQUEST;
  300. $curlValue = "HEAD";
  301. break;
  302. default:
  303. // For now, through an exception for unsupported request methods
  304. require_once 'Zend/Http/Client/Adapter/Exception.php';
  305. throw new Zend_Http_Client_Adapter_Exception("Method currently not supported");
  306. }
  307. if(is_resource($body) && $curlMethod != CURLOPT_PUT) {
  308. require_once 'Zend/Http/Client/Adapter/Exception.php';
  309. throw new Zend_Http_Client_Adapter_Exception("Streaming requests are allowed only with PUT");
  310. }
  311. // get http version to use
  312. $curlHttp = ($httpVersion == 1.1) ? CURL_HTTP_VERSION_1_1 : CURL_HTTP_VERSION_1_0;
  313. // mark as HTTP request and set HTTP method
  314. curl_setopt($this->_curl, $curlHttp, true);
  315. curl_setopt($this->_curl, $curlMethod, $curlValue);
  316. if($this->out_stream) {
  317. // headers will be read into the response
  318. curl_setopt($this->_curl, CURLOPT_HEADER, false);
  319. curl_setopt($this->_curl, CURLOPT_HEADERFUNCTION, array($this, "readHeader"));
  320. // and data will be written into the file
  321. curl_setopt($this->_curl, CURLOPT_FILE, $this->out_stream);
  322. } else {
  323. // ensure headers are also returned
  324. curl_setopt($this->_curl, CURLOPT_HEADER, true);
  325. // ensure actual response is returned
  326. curl_setopt($this->_curl, CURLOPT_RETURNTRANSFER, true);
  327. }
  328. // set additional headers
  329. $headers['Accept'] = '';
  330. curl_setopt($this->_curl, CURLOPT_HTTPHEADER, $headers);
  331. /**
  332. * Make sure POSTFIELDS is set after $curlMethod is set:
  333. * @link http://de2.php.net/manual/en/function.curl-setopt.php#81161
  334. */
  335. if ($method == Zend_Http_Client::POST) {
  336. curl_setopt($this->_curl, CURLOPT_POSTFIELDS, $body);
  337. } elseif ($curlMethod == CURLOPT_PUT) {
  338. // this covers a PUT by file-handle:
  339. // Make the setting of this options explicit (rather than setting it through the loop following a bit lower)
  340. // to group common functionality together.
  341. curl_setopt($this->_curl, CURLOPT_INFILE, $this->_config['curloptions'][CURLOPT_INFILE]);
  342. curl_setopt($this->_curl, CURLOPT_INFILESIZE, $this->_config['curloptions'][CURLOPT_INFILESIZE]);
  343. unset($this->_config['curloptions'][CURLOPT_INFILE]);
  344. unset($this->_config['curloptions'][CURLOPT_INFILESIZE]);
  345. } elseif ($method == Zend_Http_Client::PUT) {
  346. // This is a PUT by a setRawData string, not by file-handle
  347. curl_setopt($this->_curl, CURLOPT_POSTFIELDS, $body);
  348. }
  349. // set additional curl options
  350. if (isset($this->_config['curloptions'])) {
  351. foreach ((array)$this->_config['curloptions'] as $k => $v) {
  352. if (!in_array($k, $this->_invalidOverwritableCurlOptions)) {
  353. if (curl_setopt($this->_curl, $k, $v) == false) {
  354. require_once 'Zend/Http/Client/Exception.php';
  355. throw new Zend_Http_Client_Exception(sprintf("Unknown or erroreous cURL option '%s' set", $k));
  356. }
  357. }
  358. }
  359. }
  360. // send the request
  361. $response = curl_exec($this->_curl);
  362. // if we used streaming, headers are already there
  363. if(!is_resource($this->out_stream)) {
  364. $this->_response = $response;
  365. }
  366. $request = curl_getinfo($this->_curl, CURLINFO_HEADER_OUT);
  367. $request .= $body;
  368. if (empty($this->_response)) {
  369. require_once 'Zend/Http/Client/Exception.php';
  370. throw new Zend_Http_Client_Exception("Error in cURL request: " . curl_error($this->_curl));
  371. }
  372. // cURL automatically decodes chunked-messages, this means we have to disallow the Zend_Http_Response to do it again
  373. if (stripos($this->_response, "Transfer-Encoding: chunked\r\n")) {
  374. $this->_response = str_ireplace("Transfer-Encoding: chunked\r\n", '', $this->_response);
  375. }
  376. // Eliminate multiple HTTP responses.
  377. do {
  378. $parts = preg_split('|(?:\r?\n){2}|m', $this->_response, 2);
  379. $again = false;
  380. if (isset($parts[1]) && preg_match("|^HTTP/1\.[01](.*?)\r\n|mi", $parts[1])) {
  381. $this->_response = $parts[1];
  382. $again = true;
  383. }
  384. } while ($again);
  385. // cURL automatically handles Proxy rewrites, remove the "HTTP/1.0 200 Connection established" string:
  386. if (stripos($this->_response, "HTTP/1.0 200 Connection established\r\n\r\n") !== false) {
  387. $this->_response = str_ireplace("HTTP/1.0 200 Connection established\r\n\r\n", '', $this->_response);
  388. }
  389. return $request;
  390. }
  391. /**
  392. * Return read response from server
  393. *
  394. * @return string
  395. */
  396. public function read()
  397. {
  398. return $this->_response;
  399. }
  400. /**
  401. * Close the connection to the server
  402. *
  403. */
  404. public function close()
  405. {
  406. if(is_resource($this->_curl)) {
  407. curl_close($this->_curl);
  408. }
  409. $this->_curl = null;
  410. $this->_connected_to = array(null, null);
  411. }
  412. /**
  413. * Get cUrl Handle
  414. *
  415. * @return resource
  416. */
  417. public function getHandle()
  418. {
  419. return $this->_curl;
  420. }
  421. /**
  422. * Set output stream for the response
  423. *
  424. * @param resource $stream
  425. * @return Zend_Http_Client_Adapter_Socket
  426. */
  427. public function setOutputStream($stream)
  428. {
  429. $this->out_stream = $stream;
  430. return $this;
  431. }
  432. /**
  433. * Header reader function for CURL
  434. *
  435. * @param resource $curl
  436. * @param string $header
  437. * @return int
  438. */
  439. public function readHeader($curl, $header)
  440. {
  441. $this->_response .= $header;
  442. return strlen($header);
  443. }
  444. }