fetion.classes.20080731.rar_PHP 接口_PHPQQClient.rar_fetion php cl

<?php /** * @author Dick Munroe (munroe@csworks.com) * @copyright copyright @ 2004-2007, Dick Munroe, released under the GPL. * @license http://www.csworks.com/publications/ModifiedNetBSD.html * @version 1.2.0 * @package cURL * * The cURL class is a thin wrapper around the procedural interface * to cURL provided by PHP. I use it mostly as a base class for * web services whose low level interface is, literally, web pages. * * There are a few differences (value added, I guess) between the interface * provided by this class and the procedural cURL interface. Most * noticable are: * * 1. The curl::exec function (when returning data to the caller rather * than simply outputing it) always parses the HTTP header and returns * only the body portion of the reqeust. The header is available via * the curl::getHeader method. * 2. The status of the last curl::exec is always maintained. It is * available via the curl::getStatus method. In addition to the information * returned by curl_getinfo, that of curl_error and curl_errno is folded * in as well. * * @example ./example.class.curl.php */ // // Edit History: // // Dick Munroe munroe@csworks.com 30-Nov-2004 // Initial Version Created. // // Dick Munroe munroe@csworks.com 01-Dec-2004 // Forgot to check for cURL actually being in this instance of PHP. // // Dick Munroe (munroe@csworks.com) 07-Apr-2006 // Fix tab characters. // Add utility function to return post string. // // Richard W. Schlatter (richard@rth10260.info) 27-Apr-2006 // Extend processing for headers when CURLOPT_FOLLOWLOCATION is also set. // Only the headers of the final page will be used to return parsed headers. // Add utility function to return array of all collected headers. // // Dick Munroe (munroe@csworks.com) 01-May-2006 // asPostString doesn't need to be an object specific method. // // Dick Munroe (munroe@csworks.com) 02-May-2006 // Not all versions of PHP allow returning of a reference to the result // of a function. // // Richard W. Schlatter (richard@rth10260.info) 03-May-2006 // For consistency, return an empty array if there aren't any headers // to be parsed. // // Richard W. Schlatter (richard@rth10260.info) 05-Jun-2006 // Don't parse headers in the event of an error when executing a cURL request. // // Dick Munroe (munroe@csworks.com) 17-Dec-2007 1.2.0 // Add a function to parse post strings as this is frequently needed capability. class curl { /** * The mapping to caseless header names. * * @access private * @var array */ var $m_caseless ; /** * The handle for the current curl session. * * @access private * @var resource */ var $m_handle ; /** * The parsed contents of the HTTP header if one happened in the * message. All repeated elements appear as arrays. * * The headers are stored as an associative array, the key of which * is the name of the header, e.g., Set-Cookie, and the values of which * are the bodies of the header in the order in which they occurred. * * Some headers can be repeated in a single header, e.g., Set-Cookie and * pragma, so each type of header has an array containing one or more * headers of the same type. * * The names of the headers can, potentially, vary in spelling from * server to server and client to client. No attempt to regulate this * is made, i.e., the curl class does not force all headers to lower * or upper class, but it DOES collect all headers of the same type * under the spelling of the type of header used by the FIRST header * of that type. * * For example, two headers: * * 1. Set-Cookie: ... * 2. set-cookie: ... * * Would appear as $this->m_header['Set-Cookie'][0] and ...[1] * * @access private * @var mixed */ var $m_header ; /** * Current setting of the curl options. * * @access private * @var mixed */ var $m_options ; /** * Status information for the last executed http request. Includes the errno and error * in addition to the information returned by curl_getinfo. * * The keys defined are those returned by curl_getinfo with two additional * ones specified, 'error' which is the value of curl_error and 'errno' which * is the value of curl_errno. * * @link http://www.php.net/curl_getinfo * @link http://www.php.net/curl_errno * @link http://www.php.net/curl_error * @access private * @var mixed */ var $m_status ; /** * Collection of headers when curl follows redirections as per CURLOPTION_FOLLOWLOCATION. * The collection includes the headers of the final page too. * * @access private * @var array */ var $m_followed ; /** * curl class constructor * * Initializes the curl class for it's default behavior: * o no HTTP headers. * o return the transfer as a string. * o URL to access. * By default, the curl class will simply read the URL provided * in the constructor. * * @link http://www.php.net/curl_init * @param string $theURL [optional] the URL to be accessed by this instance of the class. */ function curl($theURL=null) { if (!function_exists('curl_init')) { trigger_error('PHP was not built with --with-curl, rebuild PHP to use the curl class.', E_USER_ERROR) ; } $this->m_handle = curl_init() ; $this->m_caseless = null ; $this->m_header = null ; $this->m_options = null ; $this->m_status = null ; $this->m_followed = null ; if (!empty($theURL)) { $this->setopt(CURLOPT_URL, $theURL) ; } $this->setopt(CURLOPT_HEADER, false) ; $this->setopt(CURLOPT_RETURNTRANSFER, true) ; } /** * Free the resources associated with the curl session. * * @link http://www.php.net/curl_close */ function close() { curl_close($this->m_handle) ; $this->m_handle = null ; } /** * Execute the curl request and return the result. * * @link http://www.php.net/curl_exec * @link http://www.php.net/curl_getinfo * @link http://www.php.net/curl_errno * @link http://www.php.net/curl_error * @return string The contents of the page (or other interaction as defined by the * settings of the various curl options). */ function exec() { $theReturnValue = curl_exec($this->m_handle) ; $this->m_status = curl_getinfo($this->m_handle) ; $this->m_status['errno'] = curl_errno($this->m_handle) ; $this->m_status['error'] = curl_error($this->m_handle) ; // // Collect headers espesically if CURLOPT_FOLLOWLOCATION set. // Parse out the http header (from last one if any). // $this->m_header = null ; // // If there has been a curl error, just return a null string. // if ($this->m_status['errno']) { return '' ; } if ($this->getOption(CURLOPT_HEADER)) { $this->m_followed = array() ; $rv = $theReturnValue ; while (count($this->m_followed) <= $this->m_status['redirect_count']) { $theArray = preg_split("/(\r\n){2,2}/", $rv, 2) ; $this->m_followed[] = $theArray[0] ; $rv = $theArray[1] ; } $this->parseHeader($theArray[0]) ; return $theArray[1] ; } else { return $theReturnValue ; } } /** * Returns the parsed http header. * * @param string $theHeader [optional] the name of the header to be returned. * The name of the header is case insensitive. If * the header name is omitted the parsed header is * returned. If the requested header doesn't exist * false is returned. * @returns mixed */ function getHeader($theHeader=null) { // // There can't be any headers to check if there weren't any headers // returned (happens in the event of errors). // if (empty($this->m_header)) { return false ; } if (empty($theHeader)) { return $this->m_header ; } else { $theHeader = str