src/Service/Soap/Transport_http.php line 451

Open in your IDE?
  1. <?php
  2. namespace App\Service\Soap;
  3. /**
  4. * transport class for sending/receiving data via HTTP and HTTPS
  5. * NOTE: PHP must be compiled with the CURL extension for HTTPS support
  6. *
  7. * @author   Dietrich Ayala <dietrich@ganx4.com>
  8. * @author   Scott Nichol <snichol@users.sourceforge.net>
  9. * @version  $Id: nusoap.php,v 1.123 2010/04/26 20:15:08 snichol Exp $
  10. * @access public
  11. */
  12. class Transport_http extends base {
  14.     var $url = '';
  15.     var $uri = '';
  16.     var $digest_uri = '';
  17.     var $scheme = '';
  18.     var $host = '';
  19.     var $port = '';
  20.     var $path = '';
  21.     var $request_method = 'POST';
  22.     var $protocol_version = '1.0';
  23.     var $encoding = '';
  24.     var $outgoing_headers = array();
  25.     var $incoming_headers = array();
  26.     var $incoming_cookies = array();
  27.     var $outgoing_payload = '';
  28.     var $incoming_payload = '';
  29.     var $response_status_line;    // HTTP response status line
  30.     var $useSOAPAction = true;
  31.     var $persistentConnection = false;
  32.     var $ch = false;    // cURL handle
  33.     var $ch_options = array();    // cURL custom options
  34.     var $use_curl = false;        // force cURL use
  35.     var $proxy = null;            // proxy information (associative array)
  36.     var $username = '';
  37.     var $password = '';
  38.     var $authtype = '';
  39.     var $digestRequest = array();
  40.     var $certRequest = array();    // keys must be cainfofile (optional), sslcertfile, sslkeyfile, passphrase, certpassword (optional), verifypeer (optional), verifyhost (optional)
  41.                                 // cainfofile: certificate authority file, e.g. '$pathToPemFiles/rootca.pem'
  42.                                 // sslcertfile: SSL certificate file, e.g. '$pathToPemFiles/mycert.pem'
  43.                                 // sslkeyfile: SSL key file, e.g. '$pathToPemFiles/mykey.pem'
  44.                                 // passphrase: SSL key password/passphrase
  45.                                 // certpassword: SSL certificate password
  46.                                 // verifypeer: default is 1
  47.                                 // verifyhost: default is 1
  49.     /**
  50.     * constructor
  51.     *
  52.     * @param string $url The URL to which to connect
  53.     * @param array $curl_options User-specified cURL options
  54.     * @param boolean $use_curl Whether to try to force cURL use
  55.     * @access public
  56.     */
  57.     function __construct($url, $curl_options = NULL, $use_curl = false){
  58.         parent::base();
  59.         $this->debug("ctor url=$url use_curl=$use_curl curl_options:");
  60.         $this->appendDebug($this->varDump($curl_options));
  61.         $this->setURL($url);
  62.         if (is_array($curl_options)) {
  63.             $this->ch_options = $curl_options;
  64.         }
  65.         $this->use_curl = $use_curl;
  66.         preg_match('/\$Revisio' . 'n: ([^ ]+)/', $this->revision, $rev);
  67.         $this->setHeader('User-Agent', $this->title.'/'.$this->version.' ('.$rev[1].')');
  68.     }
  70.     /**
  71.     * sets a cURL option
  72.     *
  73.     * @param    mixed $option The cURL option (always integer?)
  74.     * @param    mixed $value The cURL option value
  75.     * @access   private
  76.     */
  77.     function setCurlOption($option, $value) {
  78.         $this->debug("setCurlOption option=$option, value=");
  79.         $this->appendDebug($this->varDump($value));
  80.         curl_setopt($this->ch, $option, $value);
  81.     }
  83.     /**
  84.     * sets an HTTP header
  85.     *
  86.     * @param string $name The name of the header
  87.     * @param string $value The value of the header
  88.     * @access private
  89.     */
  90.     function setHeader($name, $value) {
  91.         $this->outgoing_headers[$name] = $value;
  92.         $this->debug("set header $name: $value");
  93.     }
  95.     /**
  96.     * unsets an HTTP header
  97.     *
  98.     * @param string $name The name of the header
  99.     * @access private
  100.     */
  101.     function unsetHeader($name) {
  102.         if (isset($this->outgoing_headers[$name])) {
  103.             $this->debug("unset header $name");
  104.             unset($this->outgoing_headers[$name]);
  105.         }
  106.     }
  108.     /**
  109.     * sets the URL to which to connect
  110.     *
  111.     * @param string $url The URL to which to connect
  112.     * @access private
  113.     */
  114.     function setURL($url) {
  115.         $this->url = $url;
  117.         $u = parse_url($url);
  118.         foreach($u as $k => $v){
  119.             $this->debug("parsed URL $k = $v");
  120.             $this->$k = $v;
  121.         }
  122.         
  123.         // add any GET params to path
  124.         if(isset($u['query']) && $u['query'] != ''){
  125.             $this->path .= '?' . $u['query'];
  126.         }
  127.         
  128.         // set default port
  129.         if(!isset($u['port'])){
  130.             if($u['scheme'] == 'https'){
  131.                 $this->port = 443;
  132.             } else {
  133.                 $this->port = 80;
  134.             }
  135.         }
  136.         
  137.         $this->uri = $this->path;
  138.         $this->digest_uri = $this->uri;
  139.         
  140.         // build headers
  141.         if (!isset($u['port'])) {
  142.             $this->setHeader('Host', $this->host);
  143.         } else {
  144.             $this->setHeader('Host', $this->host.':'.$this->port);
  145.         }
  147.         if (isset($u['user']) && $u['user'] != '') {
  148.             $this->setCredentials(urldecode($u['user']), isset($u['pass']) ? urldecode($u['pass']) : '');
  149.         }
  150.     }
  152.     /**
  153.     * gets the I/O method to use
  154.     *
  155.     * @return    string    I/O method to use (socket|curl|unknown)
  156.     * @access    private
  157.     */
  158.     function io_method() {
  159.         if ($this->use_curl || ($this->scheme == 'https') || ($this->scheme == 'http' && $this->authtype == 'ntlm') || ($this->scheme == 'http' && is_array($this->proxy) && $this->proxy['authtype'] == 'ntlm'))
  160.             return 'curl';
  161.         if (($this->scheme == 'http' || $this->scheme == 'ssl') && $this->authtype != 'ntlm' && (!is_array($this->proxy) || $this->proxy['authtype'] != 'ntlm'))
  162.             return 'socket';
  163.         return 'unknown';
  164.     }
  166.     /**
  167.     * establish an HTTP connection
  168.     *
  169.     * @param    integer $timeout set connection timeout in seconds
  170.     * @param    integer $response_timeout set response timeout in seconds
  171.     * @return    boolean true if connected, false if not
  172.     * @access   private
  173.     */
  174.     function connect($connection_timeout=0,$response_timeout=30){
  175.           // For PHP 4.3 with OpenSSL, change https scheme to ssl, then treat like
  176.           // "regular" socket.
  177.           // TODO: disabled for now because OpenSSL must be *compiled* in (not just
  178.           //       loaded), and until PHP5 stream_get_wrappers is not available.
  179. //          if ($this->scheme == 'https') {
  180. //              if (version_compare(phpversion(), '4.3.0') >= 0) {
  181. //                  if (extension_loaded('openssl')) {
  182. //                      $this->scheme = 'ssl';
  183. //                      $this->debug('Using SSL over OpenSSL');
  184. //                  }
  185. //              }
  186. //        }
  187.         $this->debug("connect connection_timeout $connection_timeout, response_timeout $response_timeout, scheme $this->scheme, host $this->host, port $this->port");
  188.       if ($this->io_method() == 'socket') {
  189.         if (!is_array($this->proxy)) {
  190.             $host = $this->host;
  191.             $port = $this->port;
  192.         } else {
  193.             $host = $this->proxy['host'];
  194.             $port = $this->proxy['port'];
  195.         }
  197.         // use persistent connection
  198.         if($this->persistentConnection && isset($this->fp) && is_resource($this->fp)){
  199.             if (!feof($this->fp)) {
  200.                 $this->debug('Re-use persistent connection');
  201.                 return true;
  202.             }
  203.             fclose($this->fp);
  204.             $this->debug('Closed persistent connection at EOF');
  205.         }
  207.         // munge host if using OpenSSL
  208.         if ($this->scheme == 'ssl') {
  209.             $host = 'ssl://' . $host;
  210.         }
  211.         $this->debug('calling fsockopen with host ' . $host . ' connection_timeout ' . $connection_timeout);
  213.         // open socket
  214.         if($connection_timeout > 0){
  215.             $this->fp = @fsockopen( $host, $this->port, $this->errno, $this->error_str, $connection_timeout);
  216.         } else {
  217.             $this->fp = @fsockopen( $host, $this->port, $this->errno, $this->error_str);
  218.         }
  219.         
  220.         // test pointer
  221.         if(!$this->fp) {
  222.             $msg = 'Couldn\'t open socket connection to server ' . $this->url;
  223.             if ($this->errno) {
  224.                 $msg .= ', Error ('.$this->errno.'): '.$this->error_str;
  225.             } else {
  226.                 $msg .= ' prior to connect().  This is often a problem looking up the host name.';
  227.             }
  228.             $this->debug($msg);
  229.             $this->setError($msg);
  230.             return false;
  231.         }
  232.         
  233.         // set response timeout
  234.         $this->debug('set response timeout to ' . $response_timeout);
  235.         socket_set_timeout( $this->fp, $response_timeout);
  237.         $this->debug('socket connected');
  238.         return true;
  239.       } else if ($this->io_method() == 'curl') {
  240.         if (!extension_loaded('curl')) {
  241. //            $this->setError('cURL Extension, or OpenSSL extension w/ PHP version >= 4.3 is required for HTTPS');
  242.             $this->setError('The PHP cURL Extension is required for HTTPS or NLTM.  You will need to re-build or update your PHP to include cURL or change php.ini to load the PHP cURL extension.');
  243.             return false;
  244.         }
  245.         // Avoid warnings when PHP does not have these options
  246.         if (defined('CURLOPT_CONNECTIONTIMEOUT'))
  247.             $CURLOPT_CONNECTIONTIMEOUT = CURLOPT_CONNECTIONTIMEOUT;
  248.         else
  249.             $CURLOPT_CONNECTIONTIMEOUT = 78;
  250.         if (defined('CURLOPT_HTTPAUTH'))
  251.             $CURLOPT_HTTPAUTH = CURLOPT_HTTPAUTH;
  252.         else
  253.             $CURLOPT_HTTPAUTH = 107;
  254.         if (defined('CURLOPT_PROXYAUTH'))
  255.             $CURLOPT_PROXYAUTH = CURLOPT_PROXYAUTH;
  256.         else
  257.             $CURLOPT_PROXYAUTH = 111;
  258.         if (defined('CURLAUTH_BASIC'))
  259.             $CURLAUTH_BASIC = CURLAUTH_BASIC;
  260.         else
  261.             $CURLAUTH_BASIC = 1;
  262.         if (defined('CURLAUTH_DIGEST'))
  263.             $CURLAUTH_DIGEST = CURLAUTH_DIGEST;
  264.         else
  265.             $CURLAUTH_DIGEST = 2;
  266.         if (defined('CURLAUTH_NTLM'))
  267.             $CURLAUTH_NTLM = CURLAUTH_NTLM;
  268.         else
  269.             $CURLAUTH_NTLM = 8;
  271.         $this->debug('connect using cURL');
  272.         // init CURL
  273.         $this->ch = curl_init();
  274.         // set url
  275.         $hostURL = ($this->port != '') ? "$this->scheme://$this->host:$this->port" : "$this->scheme://$this->host";
  276.         // add path
  277.         $hostURL .= $this->path;
  278.         $this->setCurlOption(CURLOPT_URL, $hostURL);
  279.         // follow location headers (re-directs)
  280.         if (ini_get('safe_mode') || ini_get('open_basedir')) {
  281.             $this->debug('safe_mode or open_basedir set, so do not set CURLOPT_FOLLOWLOCATION');
  282.             $this->debug('safe_mode = ');
  283.             $this->appendDebug($this->varDump(ini_get('safe_mode')));
  284.             $this->debug('open_basedir = ');
  285.             $this->appendDebug($this->varDump(ini_get('open_basedir')));
  286.         } else {
  287.             $this->setCurlOption(CURLOPT_FOLLOWLOCATION, 1);
  288.         }
  289.         // ask for headers in the response output
  290.         $this->setCurlOption(CURLOPT_HEADER, 1);
  291.         // ask for the response output as the return value
  292.         $this->setCurlOption(CURLOPT_RETURNTRANSFER, 1);
  293.         // encode
  294.         // We manage this ourselves through headers and encoding
  295. //        if(function_exists('gzuncompress')){
  296. //            $this->setCurlOption(CURLOPT_ENCODING, 'deflate');
  297. //        }
  298.         // persistent connection
  299.         if ($this->persistentConnection) {
  300.             // I believe the following comment is now bogus, having applied to
  301.             // the code when it used CURLOPT_CUSTOMREQUEST to send the request.
  302.             // The way we send data, we cannot use persistent connections, since
  303.             // there will be some "junk" at the end of our request.
  304.             //$this->setCurlOption(CURL_HTTP_VERSION_1_1, true);
  305.             $this->persistentConnection = false;
  306.             $this->setHeader('Connection', 'close');
  307.         }
  308.         // set timeouts
  309.         if ($connection_timeout != 0) {
  310.             $this->setCurlOption($CURLOPT_CONNECTIONTIMEOUT, $connection_timeout);
  311.         }
  312.         if ($response_timeout != 0) {
  313.             $this->setCurlOption(CURLOPT_TIMEOUT, $response_timeout);
  314.         }
  316.         if ($this->scheme == 'https') {
  317.             $this->debug('set cURL SSL verify options');
  318.             // recent versions of cURL turn on peer/host checking by default,
  319.             // while PHP binaries are not compiled with a default location for the
  320.             // CA cert bundle, so disable peer/host checking.
  321.             //$this->setCurlOption(CURLOPT_CAINFO, 'f:\php-4.3.2-win32\extensions\curl-ca-bundle.crt');        
  322.             $this->setCurlOption(CURLOPT_SSL_VERIFYPEER, 0);
  323.             $this->setCurlOption(CURLOPT_SSL_VERIFYHOST, 0);
  324.     
  325.             // support client certificates (thanks Tobias Boes, Doug Anarino, Eryan Ariobowo)
  326.             if ($this->authtype == 'certificate') {
  327.                 $this->debug('set cURL certificate options');
  328.                 if (isset($this->certRequest['cainfofile'])) {
  329.                     $this->setCurlOption(CURLOPT_CAINFO, $this->certRequest['cainfofile']);
  330.                 }
  331.                 if (isset($this->certRequest['verifypeer'])) {
  332.                     $this->setCurlOption(CURLOPT_SSL_VERIFYPEER, $this->certRequest['verifypeer']);
  333.                 } else {
  334.                     $this->setCurlOption(CURLOPT_SSL_VERIFYPEER, 1);
  335.                 }
  336.                 if (isset($this->certRequest['verifyhost'])) {
  337.                     $this->setCurlOption(CURLOPT_SSL_VERIFYHOST, $this->certRequest['verifyhost']);
  338.                 } else {
  339.                     $this->setCurlOption(CURLOPT_SSL_VERIFYHOST, 1);
  340.                 }
  341.                 if (isset($this->certRequest['sslcertfile'])) {
  342.                     $this->setCurlOption(CURLOPT_SSLCERT, $this->certRequest['sslcertfile']);
  343.                 }
  344.                 if (isset($this->certRequest['sslkeyfile'])) {
  345.                     $this->setCurlOption(CURLOPT_SSLKEY, $this->certRequest['sslkeyfile']);
  346.                 }
  347.                 if (isset($this->certRequest['passphrase'])) {
  348.                     $this->setCurlOption(CURLOPT_SSLKEYPASSWD, $this->certRequest['passphrase']);
  349.                 }
  350.                 if (isset($this->certRequest['certpassword'])) {
  351.                     $this->setCurlOption(CURLOPT_SSLCERTPASSWD, $this->certRequest['certpassword']);
  352.                 }
  353.             }
  354.         }
  355.         if ($this->authtype && ($this->authtype != 'certificate')) {
  356.             if ($this->username) {
  357.                 $this->debug('set cURL username/password');
  358.                 $this->setCurlOption(CURLOPT_USERPWD, "$this->username:$this->password");
  359.             }
  360.             if ($this->authtype == 'basic') {
  361.                 $this->debug('set cURL for Basic authentication');
  362.                 $this->setCurlOption($CURLOPT_HTTPAUTH, $CURLAUTH_BASIC);
  363.             }
  364.             if ($this->authtype == 'digest') {
  365.                 $this->debug('set cURL for digest authentication');
  366.                 $this->setCurlOption($CURLOPT_HTTPAUTH, $CURLAUTH_DIGEST);
  367.             }
  368.             if ($this->authtype == 'ntlm') {
  369.                 $this->debug('set cURL for NTLM authentication');
  370.                 $this->setCurlOption($CURLOPT_HTTPAUTH, $CURLAUTH_NTLM);
  371.             }
  372.         }
  373.         if (is_array($this->proxy)) {
  374.             $this->debug('set cURL proxy options');
  375.             if ($this->proxy['port'] != '') {
  376.                 $this->setCurlOption(CURLOPT_PROXY, $this->proxy['host'].':'.$this->proxy['port']);
  377.             } else {
  378.                 $this->setCurlOption(CURLOPT_PROXY, $this->proxy['host']);
  379.             }
  380.             if ($this->proxy['username'] || $this->proxy['password']) {
  381.                 $this->debug('set cURL proxy authentication options');
  382.                 $this->setCurlOption(CURLOPT_PROXYUSERPWD, $this->proxy['username'].':'.$this->proxy['password']);
  383.                 if ($this->proxy['authtype'] == 'basic') {
  384.                     $this->setCurlOption($CURLOPT_PROXYAUTH, $CURLAUTH_BASIC);
  385.                 }
  386.                 if ($this->proxy['authtype'] == 'ntlm') {
  387.                     $this->setCurlOption($CURLOPT_PROXYAUTH, $CURLAUTH_NTLM);
  388.                 }
  389.             }
  390.         }
  391.         $this->debug('cURL connection set up');
  392.         return true;
  393.       } else {
  394.         $this->setError('Unknown scheme ' . $this->scheme);
  395.         $this->debug('Unknown scheme ' . $this->scheme);
  396.         return false;
  397.       }
  398.     }
  400.     /**
  401.     * sends the SOAP request and gets the SOAP response via HTTP[S]
  402.     *
  403.     * @param    string $data message data
  404.     * @param    integer $timeout set connection timeout in seconds
  405.     * @param    integer $response_timeout set response timeout in seconds
  406.     * @param    array $cookies cookies to send
  407.     * @return    string data
  408.     * @access   public
  409.     */
  410.     function send($data, $timeout=0, $response_timeout=30, $cookies=NULL) {
  411.         
  412.         $this->debug('entered send() with data of length: '.strlen($data));
  414.         $this->tryagain = true;
  415.         $tries = 0;
  416.         while ($this->tryagain) {
  417.             $this->tryagain = false;
  418.             if ($tries++ < 2) {
  419.                 // make connnection
  420.                 if (!$this->connect($timeout, $response_timeout)){
  421.                     return false;
  422.                 }
  423.                 
  424.                 // send request
  425.                 if (!$this->sendRequest($data, $cookies)){
  426.                     return false;
  427.                 }
  428.                 
  429.                 // get response
  430.                 $respdata = $this->getResponse();
  431.             } else {
  432.                 $this->setError("Too many tries to get an OK response ($this->response_status_line)");
  433.             }
  434.         }        
  435.         $this->debug('end of send()');
  436.         return $respdata;
  437.     }
  440.     /**
  441.     * sends the SOAP request and gets the SOAP response via HTTPS using CURL
  442.     *
  443.     * @param    string $data message data
  444.     * @param    integer $timeout set connection timeout in seconds
  445.     * @param    integer $response_timeout set response timeout in seconds
  446.     * @param    array $cookies cookies to send
  447.     * @return    string data
  448.     * @access   public
  449.     * @deprecated
  450.     */
  451.     function sendHTTPS($data, $timeout=0, $response_timeout=30, $cookies) {
  452.         return $this->send($data, $timeout, $response_timeout, $cookies);
  453.     }
  454.     
  455.     /**
  456.     * if authenticating, set user credentials here
  457.     *
  458.     * @param    string $username
  459.     * @param    string $password
  460.     * @param    string $authtype (basic|digest|certificate|ntlm)
  461.     * @param    array $digestRequest (keys must be nonce, nc, realm, qop)
  462.     * @param    array $certRequest (keys must be cainfofile (optional), sslcertfile, sslkeyfile, passphrase, certpassword (optional), verifypeer (optional), verifyhost (optional): see corresponding options in cURL docs)
  463.     * @access   public
  464.     */
  465.     function setCredentials($username, $password, $authtype = 'basic', $digestRequest = array(), $certRequest = array()) {
  466.         $this->debug("setCredentials username=$username authtype=$authtype digestRequest=");
  467.         $this->appendDebug($this->varDump($digestRequest));
  468.         $this->debug("certRequest=");
  469.         $this->appendDebug($this->varDump($certRequest));
  470.         // cf. RFC 2617
  471.         if ($authtype == 'basic') {
  472.             $this->setHeader('Authorization', 'Basic '.base64_encode(str_replace(':','',$username).':'.$password));
  473.         } elseif ($authtype == 'digest') {
  474.             if (isset($digestRequest['nonce'])) {
  475.                 $digestRequest['nc'] = isset($digestRequest['nc']) ? $digestRequest['nc']++ : 1;
  476.                 
  477.                 // calculate the Digest hashes (calculate code based on digest implementation found at: http://www.rassoc.com/gregr/weblog/stories/2002/07/09/webServicesSecurityHttpDigestAuthenticationWithoutActiveDirectory.html)
  478.     
  479.                 // A1 = unq(username-value) ":" unq(realm-value) ":" passwd
  480.                 $A1 = $username. ':' . (isset($digestRequest['realm']) ? $digestRequest['realm'] : '') . ':' . $password;
  481.     
  482.                 // H(A1) = MD5(A1)
  483.                 $HA1 = md5($A1);
  484.     
  485.                 // A2 = Method ":" digest-uri-value
  486.                 $A2 = $this->request_method . ':' . $this->digest_uri;
  487.     
  488.                 // H(A2)
  489.                 $HA2 =  md5($A2);
  490.     
  491.                 // KD(secret, data) = H(concat(secret, ":", data))
  492.                 // if qop == auth:
  493.                 // request-digest  = <"> < KD ( H(A1),     unq(nonce-value)
  494.                 //                              ":" nc-value
  495.                 //                              ":" unq(cnonce-value)
  496.                 //                              ":" unq(qop-value)
  497.                 //                              ":" H(A2)
  498.                 //                            ) <">
  499.                 // if qop is missing,
  500.                 // request-digest  = <"> < KD ( H(A1), unq(nonce-value) ":" H(A2) ) > <">
  501.     
  502.                 $unhashedDigest = '';
  503.                 $nonce = isset($digestRequest['nonce']) ? $digestRequest['nonce'] : '';
  504.                 $cnonce = $nonce;
  505.                 if ($digestRequest['qop'] != '') {
  506.                     $unhashedDigest = $HA1 . ':' . $nonce . ':' . sprintf("%08d", $digestRequest['nc']) . ':' . $cnonce . ':' . $digestRequest['qop'] . ':' . $HA2;
  507.                 } else {
  508.                     $unhashedDigest = $HA1 . ':' . $nonce . ':' . $HA2;
  509.                 }
  510.     
  511.                 $hashedDigest = md5($unhashedDigest);
  512.     
  513.                 $opaque = '';    
  514.                 if (isset($digestRequest['opaque'])) {
  515.                     $opaque = ', opaque="' . $digestRequest['opaque'] . '"';
  516.                 }
  518.                 $this->setHeader('Authorization', 'Digest username="' . $username . '", realm="' . $digestRequest['realm'] . '", nonce="' . $nonce . '", uri="' . $this->digest_uri . $opaque . '", cnonce="' . $cnonce . '", nc=' . sprintf("%08x", $digestRequest['nc']) . ', qop="' . $digestRequest['qop'] . '", response="' . $hashedDigest . '"');
  519.             }
  520.         } elseif ($authtype == 'certificate') {
  521.             $this->certRequest = $certRequest;
  522.             $this->debug('Authorization header not set for certificate');
  523.         } elseif ($authtype == 'ntlm') {
  524.             // do nothing
  525.             $this->debug('Authorization header not set for ntlm');
  526.         }
  527.         $this->username = $username;
  528.         $this->password = $password;
  529.         $this->authtype = $authtype;
  530.         $this->digestRequest = $digestRequest;
  531.     }
  532.     
  533.     /**
  534.     * set the soapaction value
  535.     *
  536.     * @param    string $soapaction
  537.     * @access   public
  538.     */
  539.     function setSOAPAction($soapaction) {
  540.         $this->setHeader('SOAPAction', '"' . $soapaction . '"');
  541.     }
  542.     
  543.     /**
  544.     * use http encoding
  545.     *
  546.     * @param    string $enc encoding style. supported values: gzip, deflate, or both
  547.     * @access   public
  548.     */
  549.     function setEncoding($enc='gzip, deflate') {
  550.         if (function_exists('gzdeflate')) {
  551.             $this->protocol_version = '1.1';
  552.             $this->setHeader('Accept-Encoding', $enc);
  553.             if (!isset($this->outgoing_headers['Connection'])) {
  554.                 $this->setHeader('Connection', 'close');
  555.                 $this->persistentConnection = false;
  556.             }
  557.             // deprecated as of PHP 5.3.0
  558.             //set_magic_quotes_runtime(0);
  559.             $this->encoding = $enc;
  560.         }
  561.     }
  562.     
  563.     /**
  564.     * set proxy info here
  565.     *
  566.     * @param    string $proxyhost use an empty string to remove proxy
  567.     * @param    string $proxyport
  568.     * @param    string $proxyusername
  569.     * @param    string $proxypassword
  570.     * @param    string $proxyauthtype (basic|ntlm)
  571.     * @access   public
  572.     */
  573.     function setProxy($proxyhost, $proxyport, $proxyusername = '', $proxypassword = '', $proxyauthtype = 'basic') {
  574.         if ($proxyhost) {
  575.             $this->proxy = array(
  576.                 'host' => $proxyhost,
  577.                 'port' => $proxyport,
  578.                 'username' => $proxyusername,
  579.                 'password' => $proxypassword,
  580.                 'authtype' => $proxyauthtype
  581.             );
  582.             if ($proxyusername != '' && $proxypassword != '' && $proxyauthtype = 'basic') {
  583.                 $this->setHeader('Proxy-Authorization', ' Basic '.base64_encode($proxyusername.':'.$proxypassword));
  584.             }
  585.         } else {
  586.             $this->debug('remove proxy');
  587.             $proxy = null;
  588.             unsetHeader('Proxy-Authorization');
  589.         }
  590.     }
  591.     
  593.     /**
  594.      * Test if the given string starts with a header that is to be skipped.
  595.      * Skippable headers result from chunked transfer and proxy requests.
  596.      *
  597.      * @param    string $data The string to check.
  598.      * @returns    boolean    Whether a skippable header was found.
  599.      * @access    private
  600.      */
  601.     function isSkippableCurlHeader(&$data) {
  602.         $skipHeaders = array(    'HTTP/1.1 100',
  603.                                 'HTTP/1.0 301',
  604.                                 'HTTP/1.1 301',
  605.                                 'HTTP/1.0 302',
  606.                                 'HTTP/1.1 302',
  607.                                 'HTTP/1.0 401',
  608.                                 'HTTP/1.1 401',
  609.                                 'HTTP/1.0 200 Connection established');
  610.         foreach ($skipHeaders as $hd) {
  611.             $prefix = substr($data, 0, strlen($hd));
  612.             if ($prefix == $hd) return true;
  613.         }
  615.         return false;
  616.     }
  618.     /**
  619.     * decode a string that is encoded w/ "chunked' transfer encoding
  620.      * as defined in RFC2068 19.4.6
  621.     *
  622.     * @param    string $buffer
  623.     * @param    string $lb
  624.     * @returns    string
  625.     * @access   public
  626.     * @deprecated
  627.     */
  628.     function decodeChunked($buffer, $lb){
  629.         // length := 0
  630.         $length = 0;
  631.         $new = '';
  632.         
  633.         // read chunk-size, chunk-extension (if any) and CRLF
  634.         // get the position of the linebreak
  635.         $chunkend = strpos($buffer, $lb);
  636.         if ($chunkend == FALSE) {
  637.             $this->debug('no linebreak found in decodeChunked');
  638.             return $new;
  639.         }
  640.         $temp = substr($buffer,0,$chunkend);
  641.         $chunk_size = hexdec( trim($temp) );
  642.         $chunkstart = $chunkend + strlen($lb);
  643.         // while (chunk-size > 0) {
  644.         while ($chunk_size > 0) {
  645.             $this->debug("chunkstart: $chunkstart chunk_size: $chunk_size");
  646.             $chunkend = strpos( $buffer, $lb, $chunkstart + $chunk_size);
  647.               
  648.             // Just in case we got a broken connection
  649.               if ($chunkend == FALSE) {
  650.                   $chunk = substr($buffer,$chunkstart);
  651.                 // append chunk-data to entity-body
  652.                 $new .= $chunk;
  653.                   $length += strlen($chunk);
  654.                   break;
  655.             }
  656.             
  657.               // read chunk-data and CRLF
  658.               $chunk = substr($buffer,$chunkstart,$chunkend-$chunkstart);
  659.               // append chunk-data to entity-body
  660.               $new .= $chunk;
  661.               // length := length + chunk-size
  662.               $length += strlen($chunk);
  663.               // read chunk-size and CRLF
  664.               $chunkstart = $chunkend + strlen($lb);
  665.             
  666.               $chunkend = strpos($buffer, $lb, $chunkstart) + strlen($lb);
  667.             if ($chunkend == FALSE) {
  668.                 break; //Just in case we got a broken connection
  669.             }
  670.             $temp = substr($buffer,$chunkstart,$chunkend-$chunkstart);
  671.             $chunk_size = hexdec( trim($temp) );
  672.             $chunkstart = $chunkend;
  673.         }
  674.         return $new;
  675.     }
  676.     
  677.     /**
  678.      * Writes the payload, including HTTP headers, to $this->outgoing_payload.
  679.      *
  680.      * @param    string $data HTTP body
  681.      * @param    string $cookie_str data for HTTP Cookie header
  682.      * @return    void
  683.      * @access    private
  684.      */
  685.     function buildPayload($data, $cookie_str = '') {
  686.         // Note: for cURL connections, $this->outgoing_payload is ignored,
  687.         // as is the Content-Length header, but these are still created as
  688.         // debugging guides.
  690.         // add content-length header
  691.         if ($this->request_method != 'GET') {
  692.             $this->setHeader('Content-Length', strlen($data));
  693.         }
  695.         // start building outgoing payload:
  696.         if ($this->proxy) {
  697.             $uri = $this->url;
  698.         } else {
  699.             $uri = $this->uri;
  700.         }
  701.         $req = "$this->request_method $uri HTTP/$this->protocol_version";
  702.         $this->debug("HTTP request: $req");
  703.         $this->outgoing_payload = "$req\r\n";
  705.         // loop thru headers, serializing
  706.         foreach($this->outgoing_headers as $k => $v){
  707.             $hdr = $k.': '.$v;
  708.             $this->debug("HTTP header: $hdr");
  709.             $this->outgoing_payload .= "$hdr\r\n";
  710.         }
  712.         // add any cookies
  713.         if ($cookie_str != '') {
  714.             $hdr = 'Cookie: '.$cookie_str;
  715.             $this->debug("HTTP header: $hdr");
  716.             $this->outgoing_payload .= "$hdr\r\n";
  717.         }
  719.         // header/body separator
  720.         $this->outgoing_payload .= "\r\n";
  721.         
  722.         // add data
  723.         $this->outgoing_payload .= $data;
  724.     }
  726.     /**
  727.     * sends the SOAP request via HTTP[S]
  728.     *
  729.     * @param    string $data message data
  730.     * @param    array $cookies cookies to send
  731.     * @return    boolean    true if OK, false if problem
  732.     * @access   private
  733.     */
  734.     function sendRequest($data, $cookies = NULL) {
  735.         // build cookie string
  736.         $cookie_str = $this->getCookiesForRequest($cookies, (($this->scheme == 'ssl') || ($this->scheme == 'https')));
  738.         // build payload
  739.         $this->buildPayload($data, $cookie_str);
  741.       if ($this->io_method() == 'socket') {
  742.         // send payload
  743.         if(!fputs($this->fp, $this->outgoing_payload, strlen($this->outgoing_payload))) {
  744.             $this->setError('couldn\'t write message data to socket');
  745.             $this->debug('couldn\'t write message data to socket');
  746.             return false;
  747.         }
  748.         $this->debug('wrote data to socket, length = ' . strlen($this->outgoing_payload));
  749.         return true;
  750.       } else if ($this->io_method() == 'curl') {
  751.         // set payload
  752.         // cURL does say this should only be the verb, and in fact it
  753.         // turns out that the URI and HTTP version are appended to this, which
  754.         // some servers refuse to work with (so we no longer use this method!)
  755.         //$this->setCurlOption(CURLOPT_CUSTOMREQUEST, $this->outgoing_payload);
  756.         $curl_headers = array();
  757.         foreach($this->outgoing_headers as $k => $v){
  758.             if ($k == 'Connection' || $k == 'Content-Length' || $k == 'Host' || $k == 'Authorization' || $k == 'Proxy-Authorization') {
  759.                 $this->debug("Skip cURL header $k: $v");
  760.             } else {
  761.                 $curl_headers[] = "$k: $v";
  762.             }
  763.         }
  764.         if ($cookie_str != '') {
  765.             $curl_headers[] = 'Cookie: ' . $cookie_str;
  766.         }
  767.         $this->setCurlOption(CURLOPT_HTTPHEADER, $curl_headers);
  768.         $this->debug('set cURL HTTP headers');
  769.         if ($this->request_method == "POST") {
  770.               $this->setCurlOption(CURLOPT_POST, 1);
  771.               $this->setCurlOption(CURLOPT_POSTFIELDS, $data);
  772.             $this->debug('set cURL POST data');
  773.           } else {
  774.           }
  775.         // insert custom user-set cURL options
  776.         foreach ($this->ch_options as $key => $val) {
  777.             $this->setCurlOption($key, $val);
  778.         }
  780.         $this->debug('set cURL payload');
  781.         return true;
  782.       }
  783.     }
  785.     /**
  786.     * gets the SOAP response via HTTP[S]
  787.     *
  788.     * @return    string the response (also sets member variables like incoming_payload)
  789.     * @access   private
  790.     */
  791.     function getResponse(){
  792.         $this->incoming_payload = '';
  793.         
  794.       if ($this->io_method() == 'socket') {
  795.         // loop until headers have been retrieved
  796.         $data = '';
  797.         while (!isset($lb)){
  799.             // We might EOF during header read.
  800.             if(feof($this->fp)) {
  801.                 $this->incoming_payload = $data;
  802.                 $this->debug('found no headers before EOF after length ' . strlen($data));
  803.                 $this->debug("received before EOF:\n" . $data);
  804.                 $this->setError('server failed to send headers');
  805.                 return false;
  806.             }
  808.             $tmp = fgets($this->fp, 256);
  809.             $tmplen = strlen($tmp);
  810.             $this->debug("read line of $tmplen bytes: " . trim($tmp));
  812.             if ($tmplen == 0) {
  813.                 $this->incoming_payload = $data;
  814.                 $this->debug('socket read of headers timed out after length ' . strlen($data));
  815.                 $this->debug("read before timeout: " . $data);
  816.                 $this->setError('socket read of headers timed out');
  817.                 return false;
  818.             }
  820.             $data .= $tmp;
  821.             $pos = strpos($data,"\r\n\r\n");
  822.             if($pos > 1){
  823.                 $lb = "\r\n";
  824.             } else {
  825.                 $pos = strpos($data,"\n\n");
  826.                 if($pos > 1){
  827.                     $lb = "\n";
  828.                 }
  829.             }
  830.             // remove 100 headers
  831.             if (isset($lb) && preg_match('/^HTTP\/1.1 100/',$data)) {
  832.                 unset($lb);
  833.                 $data = '';
  834.             }//
  835.         }
  836.         // store header data
  837.         $this->incoming_payload .= $data;
  838.         $this->debug('found end of headers after length ' . strlen($data));
  839.         // process headers
  840.         $header_data = trim(substr($data,0,$pos));
  841.         $header_array = explode($lb,$header_data);
  842.         $this->incoming_headers = array();
  843.         $this->incoming_cookies = array();
  844.         foreach($header_array as $header_line){
  845.             $arr = explode(':',$header_line, 2);
  846.             if(count($arr) > 1){
  847.                 $header_name = strtolower(trim($arr[0]));
  848.                 $this->incoming_headers[$header_name] = trim($arr[1]);
  849.                 if ($header_name == 'set-cookie') {
  850.                     // TODO: allow multiple cookies from parseCookie
  851.                     $cookie = $this->parseCookie(trim($arr[1]));
  852.                     if ($cookie) {
  853.                         $this->incoming_cookies[] = $cookie;
  854.                         $this->debug('found cookie: ' . $cookie['name'] . ' = ' . $cookie['value']);
  855.                     } else {
  856.                         $this->debug('did not find cookie in ' . trim($arr[1]));
  857.                     }
  858.                 }
  859.             } else if (isset($header_name)) {
  860.                 // append continuation line to previous header
  861.                 $this->incoming_headers[$header_name] .= $lb . ' ' . $header_line;
  862.             }
  863.         }
  864.         
  865.         // loop until msg has been received
  866.         if (isset($this->incoming_headers['transfer-encoding']) && strtolower($this->incoming_headers['transfer-encoding']) == 'chunked') {
  867.             $content_length =  2147483647;    // ignore any content-length header
  868.             $chunked = true;
  869.             $this->debug("want to read chunked content");
  870.         } elseif (isset($this->incoming_headers['content-length'])) {
  871.             $content_length = $this->incoming_headers['content-length'];
  872.             $chunked = false;
  873.             $this->debug("want to read content of length $content_length");
  874.         } else {
  875.             $content_length =  2147483647;
  876.             $chunked = false;
  877.             $this->debug("want to read content to EOF");
  878.         }
  879.         $data = '';
  880.         do {
  881.             if ($chunked) {
  882.                 $tmp = fgets($this->fp, 256);
  883.                 $tmplen = strlen($tmp);
  884.                 $this->debug("read chunk line of $tmplen bytes");
  885.                 if ($tmplen == 0) {
  886.                     $this->incoming_payload = $data;
  887.                     $this->debug('socket read of chunk length timed out after length ' . strlen($data));
  888.                     $this->debug("read before timeout:\n" . $data);
  889.                     $this->setError('socket read of chunk length timed out');
  890.                     return false;
  891.                 }
  892.                 $content_length = hexdec(trim($tmp));
  893.                 $this->debug("chunk length $content_length");
  894.             }
  895.             $strlen = 0;
  896.             while (($strlen < $content_length) && (!feof($this->fp))) {
  897.                 $readlen = min(8192, $content_length - $strlen);
  898.                 $tmp = fread($this->fp, $readlen);
  899.                 $tmplen = strlen($tmp);
  900.                 $this->debug("read buffer of $tmplen bytes");
  901.                 if (($tmplen == 0) && (!feof($this->fp))) {
  902.                     $this->incoming_payload = $data;
  903.                     $this->debug('socket read of body timed out after length ' . strlen($data));
  904.                     $this->debug("read before timeout:\n" . $data);
  905.                     $this->setError('socket read of body timed out');
  906.                     return false;
  907.                 }
  908.                 $strlen += $tmplen;
  909.                 $data .= $tmp;
  910.             }
  911.             if ($chunked && ($content_length > 0)) {
  912.                 $tmp = fgets($this->fp, 256);
  913.                 $tmplen = strlen($tmp);
  914.                 $this->debug("read chunk terminator of $tmplen bytes");
  915.                 if ($tmplen == 0) {
  916.                     $this->incoming_payload = $data;
  917.                     $this->debug('socket read of chunk terminator timed out after length ' . strlen($data));
  918.                     $this->debug("read before timeout:\n" . $data);
  919.                     $this->setError('socket read of chunk terminator timed out');
  920.                     return false;
  921.                 }
  922.             }
  923.         } while ($chunked && ($content_length > 0) && (!feof($this->fp)));
  924.         if (feof($this->fp)) {
  925.             $this->debug('read to EOF');
  926.         }
  927.         $this->debug('read body of length ' . strlen($data));
  928.         $this->incoming_payload .= $data;
  929.         $this->debug('received a total of '.strlen($this->incoming_payload).' bytes of data from server');
  930.         
  931.         // close filepointer
  932.         if(
  933.             (isset($this->incoming_headers['connection']) && strtolower($this->incoming_headers['connection']) == 'close') || 
  934.             (! $this->persistentConnection) || feof($this->fp)){
  935.             fclose($this->fp);
  936.             $this->fp = false;
  937.             $this->debug('closed socket');
  938.         }
  939.         
  940.         // connection was closed unexpectedly
  941.         if($this->incoming_payload == ''){
  942.             $this->setError('no response from server');
  943.             return false;
  944.         }
  945.         
  946.         // decode transfer-encoding
  947. //        if(isset($this->incoming_headers['transfer-encoding']) && strtolower($this->incoming_headers['transfer-encoding']) == 'chunked'){
  948. //            if(!$data = $this->decodeChunked($data, $lb)){
  949. //                $this->setError('Decoding of chunked data failed');
  950. //                return false;
  951. //            }
  952.             //print "<pre>\nde-chunked:\n---------------\n$data\n\n---------------\n</pre>";
  953.             // set decoded payload
  954. //            $this->incoming_payload = $header_data.$lb.$lb.$data;
  955. //        }
  956.     
  957.       } else if ($this->io_method() == 'curl') {
  958.         // send and receive
  959.         $this->debug('send and receive with cURL');
  960.         $this->incoming_payload = curl_exec($this->ch);
  961.         $data = $this->incoming_payload;
  963.         $cErr = curl_error($this->ch);
  964.         if ($cErr != '') {
  965.             $err = 'cURL ERROR: '.curl_errno($this->ch).': '.$cErr.'<br>';
  966.             // TODO: there is a PHP bug that can cause this to SEGV for CURLINFO_CONTENT_TYPE
  967.             foreach(curl_getinfo($this->ch) as $k => $v){
  968.                 $err .= "$k: $v<br>";
  969.             }
  970.             $this->debug($err);
  971.             $this->setError($err);
  972.             curl_close($this->ch);
  973.             return false;
  974.         } else {
  975.             //echo '<pre>';
  976.             //var_dump(curl_getinfo($this->ch));
  977.             //echo '</pre>';
  978.         }
  979.         // close curl
  980.         $this->debug('No cURL error, closing cURL');
  981.         curl_close($this->ch);
  982.         
  983.         // try removing skippable headers
  984.         $savedata = $data;
  985.         while ($this->isSkippableCurlHeader($data)) {
  986.             $this->debug("Found HTTP header to skip");
  987.             if ($pos = strpos($data,"\r\n\r\n")) {
  988.                 $data = ltrim(substr($data,$pos));
  989.             } elseif($pos = strpos($data,"\n\n") ) {
  990.                 $data = ltrim(substr($data,$pos));
  991.             }
  992.         }
  994.         if ($data == '') {
  995.             // have nothing left; just remove 100 header(s)
  996.             $data = $savedata;
  997.             while (preg_match('/^HTTP\/1.1 100/',$data)) {
  998.                 if ($pos = strpos($data,"\r\n\r\n")) {
  999.                     $data = ltrim(substr($data,$pos));
  1000.                 } elseif($pos = strpos($data,"\n\n") ) {
  1001.                     $data = ltrim(substr($data,$pos));
  1002.                 }
  1003.             }
  1004.         }
  1005.         
  1006.         // separate content from HTTP headers
  1007.         if ($pos = strpos($data,"\r\n\r\n")) {
  1008.             $lb = "\r\n";
  1009.         } elseif( $pos = strpos($data,"\n\n")) {
  1010.             $lb = "\n";
  1011.         } else {
  1012.             $this->debug('no proper separation of headers and document');
  1013.             $this->setError('no proper separation of headers and document');
  1014.             return false;
  1015.         }
  1016.         $header_data = trim(substr($data,0,$pos));
  1017.         $header_array = explode($lb,$header_data);
  1018.         $data = ltrim(substr($data,$pos));
  1019.         $this->debug('found proper separation of headers and document');
  1020.         $this->debug('cleaned data, stringlen: '.strlen($data));
  1021.         // clean headers
  1022.         foreach ($header_array as $header_line) {
  1023.             $arr = explode(':',$header_line,2);
  1024.             if(count($arr) > 1){
  1025.                 $header_name = strtolower(trim($arr[0]));
  1026.                 $this->incoming_headers[$header_name] = trim($arr[1]);
  1027.                 if ($header_name == 'set-cookie') {
  1028.                     // TODO: allow multiple cookies from parseCookie
  1029.                     $cookie = $this->parseCookie(trim($arr[1]));
  1030.                     if ($cookie) {
  1031.                         $this->incoming_cookies[] = $cookie;
  1032.                         $this->debug('found cookie: ' . $cookie['name'] . ' = ' . $cookie['value']);
  1033.                     } else {
  1034.                         $this->debug('did not find cookie in ' . trim($arr[1]));
  1035.                     }
  1036.                 }
  1037.             } else if (isset($header_name)) {
  1038.                 // append continuation line to previous header
  1039.                 $this->incoming_headers[$header_name] .= $lb . ' ' . $header_line;
  1040.             }
  1041.         }
  1042.       }
  1044.         $this->response_status_line = $header_array[0];
  1045.         $arr = explode(' ', $this->response_status_line, 3);
  1046.         $http_version = $arr[0];
  1047.         $http_status = intval($arr[1]);
  1048.         $http_reason = count($arr) > 2 ? $arr[2] : '';
  1050.          // see if we need to resend the request with http digest authentication
  1051.          if (isset($this->incoming_headers['location']) && ($http_status == 301 || $http_status == 302)) {
  1052.              $this->debug("Got $http_status $http_reason with Location: " . $this->incoming_headers['location']);
  1053.              $this->setURL($this->incoming_headers['location']);
  1054.             $this->tryagain = true;
  1055.             return false;
  1056.         }
  1058.          // see if we need to resend the request with http digest authentication
  1059.          if (isset($this->incoming_headers['www-authenticate']) && $http_status == 401) {
  1060.              $this->debug("Got 401 $http_reason with WWW-Authenticate: " . $this->incoming_headers['www-authenticate']);
  1061.              if (strstr($this->incoming_headers['www-authenticate'], "Digest ")) {
  1062.                  $this->debug('Server wants digest authentication');
  1063.                  // remove "Digest " from our elements
  1064.                  $digestString = str_replace('Digest ', '', $this->incoming_headers['www-authenticate']);
  1065.                  
  1066.                  // parse elements into array
  1067.                  $digestElements = explode(',', $digestString);
  1068.                  foreach ($digestElements as $val) {
  1069.                      $tempElement = explode('=', trim($val), 2);
  1070.                      $digestRequest[$tempElement[0]] = str_replace("\"", '', $tempElement[1]);
  1071.                  }
  1073.                 // should have (at least) qop, realm, nonce
  1074.                  if (isset($digestRequest['nonce'])) {
  1075.                      $this->setCredentials($this->username, $this->password, 'digest', $digestRequest);
  1076.                      $this->tryagain = true;
  1077.                      return false;
  1078.                  }
  1079.              }
  1080.             $this->debug('HTTP authentication failed');
  1081.             $this->setError('HTTP authentication failed');
  1082.             return false;
  1083.          }
  1084.         
  1085.         if (
  1086.             ($http_status >= 300 && $http_status <= 307) ||
  1087.             ($http_status >= 400 && $http_status <= 417) ||
  1088.             ($http_status >= 501 && $http_status <= 505)
  1089.            ) {
  1090.             $this->setError("Unsupported HTTP response status $http_status $http_reason (soapclient->response has contents of the response)");
  1091.             return false;
  1092.         }
  1094.         // decode content-encoding
  1095.         if(isset($this->incoming_headers['content-encoding']) && $this->incoming_headers['content-encoding'] != ''){
  1096.             if(strtolower($this->incoming_headers['content-encoding']) == 'deflate' || strtolower($this->incoming_headers['content-encoding']) == 'gzip'){
  1097.                 // if decoding works, use it. else assume data wasn't gzencoded
  1098.                 if(function_exists('gzinflate')){
  1099.                     //$timer->setMarker('starting decoding of gzip/deflated content');
  1100.                     // IIS 5 requires gzinflate instead of gzuncompress (similar to IE 5 and gzdeflate v. gzcompress)
  1101.                     // this means there are no Zlib headers, although there should be
  1102.                     $this->debug('The gzinflate function exists');
  1103.                     $datalen = strlen($data);
  1104.                     if ($this->incoming_headers['content-encoding'] == 'deflate') {
  1105.                         if ($degzdata = @gzinflate($data)) {
  1106.                             $data = $degzdata;
  1107.                             $this->debug('The payload has been inflated to ' . strlen($data) . ' bytes');
  1108.                             if (strlen($data) < $datalen) {
  1109.                                 // test for the case that the payload has been compressed twice
  1110.                                 $this->debug('The inflated payload is smaller than the gzipped one; try again');
  1111.                                 if ($degzdata = @gzinflate($data)) {
  1112.                                     $data = $degzdata;
  1113.                                     $this->debug('The payload has been inflated again to ' . strlen($data) . ' bytes');
  1114.                                 }
  1115.                             }
  1116.                         } else {
  1117.                             $this->debug('Error using gzinflate to inflate the payload');
  1118.                             $this->setError('Error using gzinflate to inflate the payload');
  1119.                         }
  1120.                     } elseif ($this->incoming_headers['content-encoding'] == 'gzip') {
  1121.                         if ($degzdata = @gzinflate(substr($data, 10))) {    // do our best
  1122.                             $data = $degzdata;
  1123.                             $this->debug('The payload has been un-gzipped to ' . strlen($data) . ' bytes');
  1124.                             if (strlen($data) < $datalen) {
  1125.                                 // test for the case that the payload has been compressed twice
  1126.                                 $this->debug('The un-gzipped payload is smaller than the gzipped one; try again');
  1127.                                 if ($degzdata = @gzinflate(substr($data, 10))) {
  1128.                                     $data = $degzdata;
  1129.                                     $this->debug('The payload has been un-gzipped again to ' . strlen($data) . ' bytes');
  1130.                                 }
  1131.                             }
  1132.                         } else {
  1133.                             $this->debug('Error using gzinflate to un-gzip the payload');
  1134.                             $this->setError('Error using gzinflate to un-gzip the payload');
  1135.                         }
  1136.                     }
  1137.                     //$timer->setMarker('finished decoding of gzip/deflated content');
  1138.                     //print "<xmp>\nde-inflated:\n---------------\n$data\n-------------\n</xmp>";
  1139.                     // set decoded payload
  1140.                     $this->incoming_payload = $header_data.$lb.$lb.$data;
  1141.                 } else {
  1142.                     $this->debug('The server sent compressed data. Your php install must have the Zlib extension compiled in to support this.');
  1143.                     $this->setError('The server sent compressed data. Your php install must have the Zlib extension compiled in to support this.');
  1144.                 }
  1145.             } else {
  1146.                 $this->debug('Unsupported Content-Encoding ' . $this->incoming_headers['content-encoding']);
  1147.                 $this->setError('Unsupported Content-Encoding ' . $this->incoming_headers['content-encoding']);
  1148.             }
  1149.         } else {
  1150.             $this->debug('No Content-Encoding header');
  1151.         }
  1152.         
  1153.         if(strlen($data) == 0){
  1154.             $this->debug('no data after headers!');
  1155.             $this->setError('no data present after HTTP headers');
  1156.             return false;
  1157.         }
  1158.         
  1159.         return $data;
  1160.     }
  1162.     /**
  1163.      * sets the content-type for the SOAP message to be sent
  1164.      *
  1165.      * @param    string $type the content type, MIME style
  1166.      * @param    mixed $charset character set used for encoding (or false)
  1167.      * @access    public
  1168.      */
  1169.     function setContentType($type, $charset = false) {
  1170.         $this->setHeader('Content-Type', $type . ($charset ? '; charset=' . $charset : ''));
  1171.     }
  1173.     /**
  1174.      * specifies that an HTTP persistent connection should be used
  1175.      *
  1176.      * @return    boolean whether the request was honored by this method.
  1177.      * @access    public
  1178.      */
  1179.     function usePersistentConnection(){
  1180.         if (isset($this->outgoing_headers['Accept-Encoding'])) {
  1181.             return false;
  1182.         }
  1183.         $this->protocol_version = '1.1';
  1184.         $this->persistentConnection = true;
  1185.         $this->setHeader('Connection', 'Keep-Alive');
  1186.         return true;
  1187.     }
  1189.     /**
  1190.      * parse an incoming Cookie into it's parts
  1191.      *
  1192.      * @param    string $cookie_str content of cookie
  1193.      * @return    array with data of that cookie
  1194.      * @access    private
  1195.      */
  1196.     /*
  1197.      * TODO: allow a Set-Cookie string to be parsed into multiple cookies
  1198.      */
  1199.     function parseCookie($cookie_str) {
  1200.         $cookie_str = str_replace('; ', ';', $cookie_str) . ';';
  1201.         $data = preg_split('/;/', $cookie_str);
  1202.         $value_str = $data[0];
  1204.         $cookie_param = 'domain=';
  1205.         $start = strpos($cookie_str, $cookie_param);
  1206.         if ($start > 0) {
  1207.             $domain = substr($cookie_str, $start + strlen($cookie_param));
  1208.             $domain = substr($domain, 0, strpos($domain, ';'));
  1209.         } else {
  1210.             $domain = '';
  1211.         }
  1213.         $cookie_param = 'expires=';
  1214.         $start = strpos($cookie_str, $cookie_param);
  1215.         if ($start > 0) {
  1216.             $expires = substr($cookie_str, $start + strlen($cookie_param));
  1217.             $expires = substr($expires, 0, strpos($expires, ';'));
  1218.         } else {
  1219.             $expires = '';
  1220.         }
  1222.         $cookie_param = 'path=';
  1223.         $start = strpos($cookie_str, $cookie_param);
  1224.         if ( $start > 0 ) {
  1225.             $path = substr($cookie_str, $start + strlen($cookie_param));
  1226.             $path = substr($path, 0, strpos($path, ';'));
  1227.         } else {
  1228.             $path = '/';
  1229.         }
  1230.                         
  1231.         $cookie_param = ';secure;';
  1232.         if (strpos($cookie_str, $cookie_param) !== FALSE) {
  1233.             $secure = true;
  1234.         } else {
  1235.             $secure = false;
  1236.         }
  1238.         $sep_pos = strpos($value_str, '=');
  1240.         if ($sep_pos) {
  1241.             $name = substr($value_str, 0, $sep_pos);
  1242.             $value = substr($value_str, $sep_pos + 1);
  1243.             $cookie= array(    'name' => $name,
  1244.                             'value' => $value,
  1245.                             'domain' => $domain,
  1246.                             'path' => $path,
  1247.                             'expires' => $expires,
  1248.                             'secure' => $secure
  1249.                             );        
  1250.             return $cookie;
  1251.         }
  1252.         return false;
  1253.     }
  1254.   
  1255.     /**
  1256.      * sort out cookies for the current request
  1257.      *
  1258.      * @param    array $cookies array with all cookies
  1259.      * @param    boolean $secure is the send-content secure or not?
  1260.      * @return    string for Cookie-HTTP-Header
  1261.      * @access    private
  1262.      */
  1263.     function getCookiesForRequest($cookies, $secure=false) {
  1264.         $cookie_str = '';
  1265.         if ((! is_null($cookies)) && (is_array($cookies))) {
  1266.             foreach ($cookies as $cookie) {
  1267.                 if (! is_array($cookie)) {
  1268.                     continue;
  1269.                 }
  1270.                 $this->debug("check cookie for validity: ".$cookie['name'].'='.$cookie['value']);
  1271.                 if ((isset($cookie['expires'])) && (! empty($cookie['expires']))) {
  1272.                     if (strtotime($cookie['expires']) <= time()) {
  1273.                         $this->debug('cookie has expired');
  1274.                         continue;
  1275.                     }
  1276.                 }
  1277.                 if ((isset($cookie['domain'])) && (! empty($cookie['domain']))) {
  1278.                     $domain = preg_quote($cookie['domain']);
  1279.                     if (! preg_match("'.*$domain$'i", $this->host)) {
  1280.                         $this->debug('cookie has different domain');
  1281.                         continue;
  1282.                     }
  1283.                 }
  1284.                 if ((isset($cookie['path'])) && (! empty($cookie['path']))) {
  1285.                     $path = preg_quote($cookie['path']);
  1286.                     if (! preg_match("'^$path.*'i", $this->path)) {
  1287.                         $this->debug('cookie is for a different path');
  1288.                         continue;
  1289.                     }
  1290.                 }
  1291.                 if ((! $secure) && (isset($cookie['secure'])) && ($cookie['secure'])) {
  1292.                     $this->debug('cookie is secure, transport is not');
  1293.                     continue;
  1294.                 }
  1295.                 $cookie_str .= $cookie['name'] . '=' . $cookie['value'] . '; ';
  1296.                 $this->debug('add cookie to Cookie-String: ' . $cookie['name'] . '=' . $cookie['value']);
  1297.             }
  1298.         }
  1299.         return $cookie_str;
  1300.   }
  1301. }