1 | <?php |
---|
2 | // |
---|
3 | // +----------------------------------------------------------------------+ |
---|
4 | // | PHP Version 4 | |
---|
5 | // +----------------------------------------------------------------------+ |
---|
6 | // | Copyright (c) 1997-2003 The PHP Group | |
---|
7 | // +----------------------------------------------------------------------+ |
---|
8 | // | This source file is subject to version 2.02 of the PHP license, | |
---|
9 | // | that is bundled with this package in the file LICENSE, and is | |
---|
10 | // | available at through the world-wide-web at | |
---|
11 | // | http://www.php.net/license/2_02.txt. | |
---|
12 | // | If you did not receive a copy of the PHP license and are unable to | |
---|
13 | // | obtain it through the world-wide-web, please send a note to | |
---|
14 | // | license@php.net so we can mail you a copy immediately. | |
---|
15 | // +----------------------------------------------------------------------+ |
---|
16 | // | Authors: Shane Caraveo <Shane@Caraveo.com> | |
---|
17 | // +----------------------------------------------------------------------+ |
---|
18 | // |
---|
19 | // $Id: example_server.php,v 1.6 2007/01/22 11:51:45 yunosh Exp $ |
---|
20 | // |
---|
21 | |
---|
22 | // first, include the SOAP/Server class |
---|
23 | require_once 'SOAP/Value.php'; |
---|
24 | require_once 'SOAP/Fault.php'; |
---|
25 | |
---|
26 | // SOAPStruct is defined in the following file |
---|
27 | require_once 'example_types.php'; |
---|
28 | |
---|
29 | // create a class for your soap functions |
---|
30 | class SOAP_Example_Server { |
---|
31 | /** |
---|
32 | * The dispactch map does not need to be used, but aids |
---|
33 | * the server class in knowing what parameters are used |
---|
34 | * with the functions. This is the ONLY way to have |
---|
35 | * multiple OUT parameters. If you use a dispatch map, you |
---|
36 | * MUST add ALL functions you wish to allow be called. If |
---|
37 | * you do not use a dispatch map, then any public function |
---|
38 | * can be called from soap (in php4, we consider this to be |
---|
39 | * any function in the class unless it starts with underscore, |
---|
40 | * php5 support is not complete yet in this regard). |
---|
41 | * if you do not define in/out parameters, the function can be |
---|
42 | * called with parameters, but no validation on parameters will |
---|
43 | * occure. |
---|
44 | */ |
---|
45 | var $__dispatch_map = array(); |
---|
46 | |
---|
47 | function SOAP_Example_Server() { |
---|
48 | /** |
---|
49 | * when generating wsdl for a server, you have to define |
---|
50 | * any special complex types that you use (ie classes). |
---|
51 | * using a namespace id before the type will create an |
---|
52 | * xml schema with the targetNamespace for the type |
---|
53 | * multiple types with the same namespace will appear |
---|
54 | * in the same schema section. types with different |
---|
55 | * namespaces will be in seperate schema sections. |
---|
56 | * the following SOAPStruct typedef cooresponds to the |
---|
57 | * SOAPStruct class above. |
---|
58 | */ |
---|
59 | $this->__typedef['{http://soapinterop.org/xsd}SOAPStruct'] = |
---|
60 | array( |
---|
61 | 'varString' => 'string', |
---|
62 | 'varInt' => 'int', |
---|
63 | 'varFloat' => 'float' |
---|
64 | ); |
---|
65 | |
---|
66 | // an aliased function with multiple out parameters |
---|
67 | $this->__dispatch_map['echoStructAsSimpleTypes'] = |
---|
68 | array('in' => array('inputStruct' => '{http://soapinterop.org/xsd}SOAPStruct'), |
---|
69 | 'out' => array('outputString' => 'string', 'outputInteger' => 'int', 'outputFloat' => 'float'), |
---|
70 | 'alias' => 'myEchoStructAsSimpleTypes' |
---|
71 | ); |
---|
72 | $this->__dispatch_map['echoStringSimple'] = |
---|
73 | array('in' => array('inputStringSimple' => 'string'), |
---|
74 | 'out' => array('outputStringSimple' => 'string'), |
---|
75 | ); |
---|
76 | $this->__dispatch_map['echoString'] = |
---|
77 | array('in' => array('inputString' => 'string'), |
---|
78 | 'out' => array('outputString' => 'string'), |
---|
79 | ); |
---|
80 | $this->__dispatch_map['divide'] = |
---|
81 | array('in' => array('dividend' => 'int', 'divisor' => 'int'), |
---|
82 | 'out' => array('outputFloat' => 'float'), |
---|
83 | ); |
---|
84 | $this->__dispatch_map['echoStruct'] = |
---|
85 | array('in' => array('inputStruct' => '{http://soapinterop.org/xsd}SOAPStruct'), |
---|
86 | 'out' => array('outputStruct' => '{http://soapinterop.org/xsd}SOAPStruct'), |
---|
87 | ); |
---|
88 | |
---|
89 | $this->__dispatch_map['echoMimeAttachment'] = array(); |
---|
90 | } |
---|
91 | |
---|
92 | /* this private function is called on by SOAP_Server to determine any |
---|
93 | special dispatch information that might be necessary. This, for example, |
---|
94 | can be used to set up a dispatch map for functions that return multiple |
---|
95 | OUT parameters */ |
---|
96 | function __dispatch($methodname) { |
---|
97 | if (isset($this->__dispatch_map[$methodname])) |
---|
98 | return $this->__dispatch_map[$methodname]; |
---|
99 | return NULL; |
---|
100 | } |
---|
101 | |
---|
102 | // a simple echoString function |
---|
103 | function echoStringSimple($inputString) |
---|
104 | { |
---|
105 | return $inputString; |
---|
106 | } |
---|
107 | |
---|
108 | // an explicit echostring function |
---|
109 | function echoString($inputString) |
---|
110 | { |
---|
111 | return new SOAP_Value('outputString','string',$inputString); |
---|
112 | } |
---|
113 | |
---|
114 | function divide($dividend, $divisor) |
---|
115 | { |
---|
116 | // the soap server would normally catch errors like this |
---|
117 | // and return a fault, but this is how you do it yourself. |
---|
118 | if ($divisor == 0) |
---|
119 | return new SOAP_Fault('You cannot divide by zero', 'Client'); |
---|
120 | else |
---|
121 | return $dividend / $divisor; |
---|
122 | } |
---|
123 | |
---|
124 | function echoStruct($inputStruct) |
---|
125 | { |
---|
126 | return $inputStruct->__to_soap('outputStruct'); |
---|
127 | } |
---|
128 | |
---|
129 | /** |
---|
130 | * echoStructAsSimpleTypes |
---|
131 | * takes a SOAPStruct as input, and returns each of its elements |
---|
132 | * as OUT parameters |
---|
133 | * |
---|
134 | * this function is also aliased so you have to call it with |
---|
135 | * echoStructAsSimpleTypes |
---|
136 | * |
---|
137 | * SOAPStruct is defined as: |
---|
138 | * |
---|
139 | * struct SOAPStruct: |
---|
140 | * string varString |
---|
141 | * integer varInt |
---|
142 | * float varFloat |
---|
143 | * |
---|
144 | */ |
---|
145 | function myEchoStructAsSimpleTypes($struct) |
---|
146 | { |
---|
147 | # convert a SOAPStruct to an array |
---|
148 | return array( |
---|
149 | new SOAP_Value('outputString','string',$struct->varString), |
---|
150 | new SOAP_Value('outputInteger','int',$struct->varInt), |
---|
151 | new SOAP_Value('outputFloat','float',$struct->varFloat) |
---|
152 | ); |
---|
153 | } |
---|
154 | |
---|
155 | function echoMimeAttachment($stuff) |
---|
156 | { |
---|
157 | return new SOAP_Attachment('return','application/octet-stream',NULL,$stuff); |
---|
158 | } |
---|
159 | } |
---|
160 | |
---|
161 | ?> |
---|