1 | <?php
|
---|
2 | /**
|
---|
3 | * This file contains the code for an abstract transport layer.
|
---|
4 | *
|
---|
5 | * PHP versions 4 and 5
|
---|
6 | *
|
---|
7 | * LICENSE: This source file is subject to version 2.02 of the PHP license,
|
---|
8 | * that is bundled with this package in the file LICENSE, and is available at
|
---|
9 | * through the world-wide-web at http://www.php.net/license/2_02.txt. If you
|
---|
10 | * did not receive a copy of the PHP license and are unable to obtain it
|
---|
11 | * through the world-wide-web, please send a note to license@php.net so we can
|
---|
12 | * mail you a copy immediately.
|
---|
13 | *
|
---|
14 | * @category Web Services
|
---|
15 | * @package SOAP
|
---|
16 | * @author Dietrich Ayala <dietrich@ganx4.com>
|
---|
17 | * @author Shane Caraveo <Shane@Caraveo.com>
|
---|
18 | * @author Jan Schneider <jan@horde.org>
|
---|
19 | * @copyright 2003-2006 The PHP Group
|
---|
20 | * @license http://www.php.net/license/2_02.txt PHP License 2.02
|
---|
21 | * @link http://pear.php.net/package/SOAP
|
---|
22 | */
|
---|
23 |
|
---|
24 | require_once 'SOAP/Base.php';
|
---|
25 |
|
---|
26 | /**
|
---|
27 | * SOAP Transport Layer
|
---|
28 | *
|
---|
29 | * This layer can use different protocols dependant on the endpoint url
|
---|
30 | * provided.
|
---|
31 | *
|
---|
32 | * No knowlege of the SOAP protocol is available at this level.
|
---|
33 | * No knowlege of the transport protocols is available at this level.
|
---|
34 | *
|
---|
35 | * @access public
|
---|
36 | * @package SOAP
|
---|
37 | * @author Shane Caraveo <shane@php.net>
|
---|
38 | * @author Jan Schneider <jan@horde.org>
|
---|
39 | */
|
---|
40 | class SOAP_Transport extends SOAP_Base
|
---|
41 | {
|
---|
42 | /**
|
---|
43 | * Connection endpoint URL.
|
---|
44 | *
|
---|
45 | * @var string
|
---|
46 | */
|
---|
47 | var $url = '';
|
---|
48 |
|
---|
49 | /**
|
---|
50 | * Array containing urlparts.
|
---|
51 | *
|
---|
52 | * @see parse_url()
|
---|
53 | *
|
---|
54 | * @var mixed
|
---|
55 | */
|
---|
56 | var $urlparts = null;
|
---|
57 |
|
---|
58 | /**
|
---|
59 | * Incoming payload.
|
---|
60 | *
|
---|
61 | * @var string
|
---|
62 | */
|
---|
63 | var $incoming_payload = '';
|
---|
64 |
|
---|
65 | /**
|
---|
66 | * Outgoing payload.
|
---|
67 | *
|
---|
68 | * @var string
|
---|
69 | */
|
---|
70 | var $outgoing_payload = '';
|
---|
71 |
|
---|
72 | /**
|
---|
73 | * Request encoding.
|
---|
74 | *
|
---|
75 | * @var string
|
---|
76 | */
|
---|
77 | var $encoding = SOAP_DEFAULT_ENCODING;
|
---|
78 |
|
---|
79 | /**
|
---|
80 | * Response encoding.
|
---|
81 | *
|
---|
82 | * We assume UTF-8 if no encoding is set.
|
---|
83 | *
|
---|
84 | * @var string
|
---|
85 | */
|
---|
86 | var $result_encoding = 'UTF-8';
|
---|
87 |
|
---|
88 | /**
|
---|
89 | * Decoded attachments from the reponse.
|
---|
90 | *
|
---|
91 | * @var array
|
---|
92 | */
|
---|
93 | var $attachments;
|
---|
94 |
|
---|
95 | /**
|
---|
96 | * Request User-Agent.
|
---|
97 | *
|
---|
98 | * @var string
|
---|
99 | */
|
---|
100 | var $_userAgent = SOAP_LIBRARY_NAME;
|
---|
101 |
|
---|
102 | /**
|
---|
103 | * Sends and receives SOAP data.
|
---|
104 | *
|
---|
105 | * @access public
|
---|
106 | * @abstract
|
---|
107 | *
|
---|
108 | * @param string Outgoing SOAP data.
|
---|
109 | * @param array Options.
|
---|
110 | *
|
---|
111 | * @return string|SOAP_Fault
|
---|
112 | */
|
---|
113 | function send($msg, $options = null)
|
---|
114 | {
|
---|
115 | return $this->_raiseSoapFault('SOAP_Transport::send() not implemented.');
|
---|
116 | }
|
---|
117 |
|
---|
118 | function &getTransport($url, $encoding = SOAP_DEFAULT_ENCODING)
|
---|
119 | {
|
---|
120 | $urlparts = @parse_url($url);
|
---|
121 |
|
---|
122 | if (!$urlparts['scheme']) {
|
---|
123 | $fault = SOAP_Base_Object::_raiseSoapFault("Invalid transport URI: $url");
|
---|
124 | return $fault;
|
---|
125 | }
|
---|
126 |
|
---|
127 | if (strcasecmp($urlparts['scheme'], 'mailto') == 0) {
|
---|
128 | $transport_type = 'SMTP';
|
---|
129 | } elseif (strcasecmp($urlparts['scheme'], 'https') == 0) {
|
---|
130 | $transport_type = 'HTTP';
|
---|
131 | } else {
|
---|
132 | /* Handle other transport types */
|
---|
133 | $transport_type = strtoupper($urlparts['scheme']);
|
---|
134 | }
|
---|
135 | $transport_include = 'SOAP/Transport/' . basename($transport_type) . '.php';
|
---|
136 | $res = @include_once($transport_include);
|
---|
137 | if (!$res) {
|
---|
138 | $fault = SOAP_Base_Object::_raiseSoapFault("No Transport for {$urlparts['scheme']}");
|
---|
139 | return $fault;
|
---|
140 | }
|
---|
141 | $transport_class = "SOAP_Transport_$transport_type";
|
---|
142 | if (!class_exists($transport_class)) {
|
---|
143 | $fault = SOAP_Base_Object::_raiseSoapFault("No Transport class $transport_class");
|
---|
144 | return $fault;
|
---|
145 | }
|
---|
146 | $t =& new $transport_class($url, $encoding);
|
---|
147 |
|
---|
148 | return $t;
|
---|
149 | }
|
---|
150 |
|
---|
151 | }
|
---|