👩🏿‍⚖️ 👩🏻‍🍳 💇🏻 SOAPクライアントサーバーアプリケーションをPHPで記述します 🔈 👩🏿‍🏭 💆

みなさんこんにちは！
つい最近、私はWebサービスの開発を始めました。しかし、今日のトピックは私に関するものではなく、SOAP 1.2プロトコルに基づいてXML Webサービスを作成する方法に関するものです。

トピックを読んだ後、次のことができることを願っています。

Webアプリケーションの独自のサーバー実装を作成します。
Webアプリケーションの独自のクライアント実装を作成します。
独自のWebサービス記述（WSDL）を作成します。
同じタイプのデータのクライアント配列によってサーバーに送信します。

ご想像のとおり、すべての魔法はPHPとSoapClientおよびSoapServer組み込みクラスを使用して行われます。うさぎとして、SMSメッセージを送信するサービスがあります。

1問題文

1.1境界線

最初に、トピックの最後で達成する結果に対処することを提案します。上記で発表したように、SMSメッセージを送信するためのサービスを作成します。より正確には、SOAPプロトコルを介してさまざまなソースからメッセージを受信します。その後、どの形式でサーバーに来るかを検討します。残念ながら、プロバイダにさらに送信するためにメッセージをキューに入れるプロセスは、多くの理由でこの投稿の範囲外です。

1.2どのデータが変更されますか？

さて、国境を決めました！次のステップは、サーバーとクライアント間で交換するデータを決定することです。このテーマについて、私は長い間頭が良くないことを提案し、すぐに自分自身の主要な質問に答えます：

SMSメッセージをサブスクライバーに送信するために、サーバーに送信する必要がある最小データは何ですか？
クライアントのニーズを満たすために、サーバーからどのような最小データを送信する必要がありますか？

このためには、次の情報を送信する必要があることがわかります。

携帯電話番号も
SMSメッセージテキスト。

原則として、これら2つの特性は送信に十分ですが、誕生日を祝うSMSが午前3時または4時に届く場合をすぐに考えます！この瞬間、私が忘れられないことを皆に感謝します！したがって、サーバーにも送信し、

SMSが送信された日付。

次にサーバーに送信したいのは

メッセージのタイプ。

このパラメーターは必須ではありませんが、ニュースを「喜んで」くれた顧客の数を上司にすぐに伝える必要があり、これに関するいくつかの良い統計を描画する必要がある場合、非常に役立ちます。

それでも、私は何かを忘れました！もう少し反射する場合、クライアントは一度に1つのSMSメッセージとその一部をサーバーに送信できることに注意してください。つまり、1つのデータパケットに1〜無限のメッセージを含めることができます。

その結果、SMSメッセージを送信するには次のデータが必要になります。

携帯電話番号
SMSテキストメッセージ
SMSメッセージを加入者に送信する時間、
メッセージのタイプ。

最初の質問に答えましたが、今度は2番目の質問に答える必要があります。そして、おそらく私は自分自身に少しハックを許可します。したがって、サーバーからブール値データのみを送信します。その値の意味は次のとおりです。

TRUE-パケットはサーバーに正常に到達し、認証に合格し、SMSプロバイダーに送信するためにキューに配置されました
FALSE-他のすべての場合

これで、問題ステートメントの説明が終わりました！最後に、楽しい部分に取り掛かりましょう。このSOAPが奇妙な獣であることがわかります。

2 SOAPとは何ですか？

一般的に、最初はSOAPとは何かを書くつもりはなかったので、必要な仕様を備えたw3.orgウェブサイトへのリンクとWikipediaへのリンクに限定したかった。しかし、最後に私はこのプロトコルについて短いメモを書くことにしました。

そして、このデータ交換プロトコルは、いわゆるRPC（リモートプロシージャコール）パラダイムに基づくプロトコルのサブセットを参照するという事実から話を始めます。そのパラポッドはREST（Representational State Transfer、代表状態転送）です。これについての詳細はウィキペディアで読むことができます。記事へのリンクはトピックの最後にあります。これらの記事から、次のことを明確にする必要があります。「RPCアプローチを使用すると、多数のメソッドと複雑なプロトコルで少量のネットワークリソースを使用できます。 RESTアプローチでは、メソッドの数とプロトコルの複雑さが厳密に制限されているため、個々のリソースの数が多くなる可能性があります。つまり、私たちに関しては、RPCアプローチの場合、サイトにはサービスへの入力（リンク）が常に1つあり、RESTアプローチでは、データと一緒に着信データを処理するために呼び出す手順が常に存在するということです。サイトには多くの入力（リンク）があり、それぞれが特定のデータのみを受信して処理します。読者の一人が、これらのアプローチの違いをより簡単に説明する方法を知っているなら、コメントを書いてください！

SOAPについて次に学ぶ必要があるのは、このプロトコルがトランスポートと同じXMLを使用することです。すぐに、このマークアップ言語に基づいた技術のスタックのすべての力が私たちの武器、つまりXML-Schema-XMLドキュメントの構造を記述するための言語になります（Wikipediaのおかげ！）、クライアントからサーバーに来るデータの自動検証を可能にします。

したがって、SOAPはリモートプロシージャコールの実装に使用されるプロトコルであり、XMLをトランスポートとして使用することがわかりました。 Wikipediaの記事を読むと、そこから、HTTPとのペアリングだけでなく、アプリケーションレベルのプロトコルで使用できることもわかります（残念ながら、このトピックではHTTP経由のSOAPのみを検討します）。そして、あなたは私がこのすべてについて最も好きなものを知っていますか？推測がない場合は、ヒントを表示します-SOAP！...推測が表示されませんでしたか？... Wikipediaの記事を間違いなく読みましたか？...一般的に、これ以上迷惑をかけません。したがって、私はすぐに答えに行きます：「SOAP（英語から。Simple Object Access Protocol-オブジェクトにアクセスするための単純なプロトコル 。 仕様1.2まで ）。」この行で最も注目すべきは斜体です！このすべてからあなたがどのような結論を出したのかわかりませんが、次のように見えます-このプロトコルは決して「シンプル」と呼ぶことはできないため（そして明らかにw3もそれに同意します）、バージョン1.2から一般的に何らかの方法で解読を停止しました！そして、それはSOAPと呼ばれ、単にSOAPと呼ばれました。

さて、大丈夫、すみません、少し横に滑りました。前に書いたように、XMLはトランスポートとして使用され、クライアントとサーバー間で実行されるパケットはSOAPエンベロープと呼ばれます。エンベロープの一般化された構造を考慮すると、非常に馴染みがあるように思えます。 HTMLページの構造に似ています。メインセクション-Envelopがあり 、これにはHeaderセクションとBodyセクション、またはFaultセクションが含まれます。データはボディに転送され、エンベロープの必須セクションですが、 ヘッダーはオプションです。 Headerでは、許可、またはWebサービスプロシージャの入力データに直接関連しないその他のデータを転送できます。 エラーについて話をする特別なことはありませんが、エラーが発生した場合にサーバーからクライアントに通知される点が異なります。

これで、SOAPプロトコルの概要が終了し（クライアントとサーバーが相互に実行する方法を最終的に学習するときに、エンベロープ自体とその構造をさらに詳しく調べます）、 WSDL （Webサービス記述言語）と呼ばれるSOAPコンパニオンについて。はい、はい、これはまさにこのプロトコルでAPIを取得して実装しようとする試みから私たちのほとんどを怖がらせるものです。その結果、通常、JSONをトランスポートとして使用して自転車を発明します。それでは、WSDLとは何ですか？ WSDLは、WikipediaのXML（c）言語に基づいたWebサービス記述およびアクセス言語です。この定義から、このテクノロジーの神聖な意味全体を理解していない場合は、自分の言葉で説明しようと思います！

WSDLは、クライアントがサーバーと正常に通信できるように設計されています。これを行うために、拡張子が* .wsdlのファイルに次の情報が記述されています。

使用された名前空間、
使用されたデータスキーム、
Webサービスが顧客に期待するメッセージの種類は、
どのデータがどのWebサービスプロシージャに属しているか、
Webサービスにはどのような手順が含まれていますか？
クライアントはどのようにWebサービスプロシージャを呼び出す必要がありますか。
クライアント呼び出しの送信先アドレス。

ご覧のとおり、このファイルはWebサービス全体です。クライアントでWSDLファイルのアドレスを指定すると、Webサービスに関するすべてがわかります。その結果、Webサービス自体の場所について絶対に知る必要はありません。 WSDLファイルの場所アドレスを知るだけで十分です！ SOAPは、ロシアのことわざ（c）で描かれているほどひどくないことがすぐにわかります。

3 XMLスキーマの概要

これで、SOAPが何であるか、SOAPが何であるかについて多くのことを理解し、SOAPがそれを取り巻くテクノロジースタックの概要を把握できました。まず、SOAPはクライアントとサーバー間のやり取りの方法であり、XMLマークアップ言語がそのトランスポートとして使用されるため、このセクションでは、XMLスキームを介した自動データ検証がどのように発生するかを少し見ていきます。

スキームの主なタスクは、処理するデータの構造を記述することです。 XMLスキーマのすべてのデータは、単純（スカラー）型と複雑（構造）型に分けられます。単純型には次のような型が含まれます。

ひも
数
ブール値
日付

内部に拡張機能がない非常に単純なもの。それらの対掌体は複雑な複合型です。誰もが思い浮かぶ複雑なタイプの最も単純な例はオブジェクトです。たとえば、本。この本は、著者、 タイトル 、価格、 ISBN番号などのプロパティで構成されています。そして、これらのプロパティは、単純なタイプでも複雑なタイプでもかまいません。そして、XMLスキーマのタスクはそれを記述することです。

SMSメッセージ用にXMLスキーマを作成することをお勧めします。以下は、SMSメッセージのxmlの説明です。

<message> <phone>71239876543</phone> <text> </text> <date>2013-07-20T12:00:00</date> <type>12</type> </message>

複雑なタイプ図は次のようになります。

 <element name="message" type="Message" /> <complexType name="Message"> <sequence> <element name="phone" type="string" /> <element name="text" type="string" /> <element name="date" type="dateTime" /> <element name="type" type="decimal" /> </sequence> </complexType>

このエントリは、次のように読み取られます。「 Message 」タイプの変数「 message 」と、「 Message 」という複合タイプがあり、「 string 」タイプの要素「 phone 」、「 string 」タイプの「 text 」、「 dateTime 」タイプの「 date 」、タイプ10進数の " タイプ "。これらのタイプは単純で、スキーマの説明ですでに定義されています。おめでとうございます！最初のXMLスキーマを作成しました！

要素「 element 」と「 complexType 」の意味は多かれ少なかれ明確になったと思うので、それらに焦点を合わせず、すぐに要素コンポーザー「 sequence 」に切り替えます。 composer要素「 sequence 」を使用する場合、それに含まれる要素は常に図に示されている順序で配置する必要があり、それらはすべて必須です。しかし、絶望しないでください！ XMLスキーマには、さらに2つのcomposer要素があります： choiceとallです。作曲家「 choice 」は、リストされている要素のいずれか1つが存在する必要があることと、作曲家「 all 」-リストされた要素の任意の組み合わせを報告します。

覚えているように、トピックの最初のセクションでは、パケットでsmsメッセージを1から無限に送信できることに同意しました。したがって、このようなデータがXMLスキーマでどのように宣言されているかを理解することを提案します。全体的なパッケージ構造は次のようになります。

 <messageList> <message> <phone>71239876543</phone> <text>  1</text> <date>2013-07-20T12:00:00</date> <type>12</type> </message> <!-- ... --> <message> <phone>71239876543</phone> <text>  N</text> <date>2013-07-20T12:00:00</date> <type>12</type> </message> </messageList>

この複合型のスキーマは次のようになります。

 <complexType name="Message"> <sequence> <element name="phone" type="string" minOccurs="1" maxOccurs="1" /> <element name="text" type="string" minOccurs="1" maxOccurs="1" /> <element name="date" type="dateTime" minOccurs="1" maxOccurs="1" /> <element name="type" type="decimal" minOccurs="1" maxOccurs="1" /> </sequence> </complexType> <element name="messageList" type="MessageList" /> <complexType name="MessageList"> <sequence> <element minOccurs="1" maxOccurs="unbounded" name="message" type="Message"/> </sequence> </complexType>

最初のブロックには、複合型「 Message 」のよく知られた宣言が含まれています。お気づきの方は、「 メッセージ 」に含まれる各単純型に、新しい修飾属性「 minOccurs 」と「 maxOccurs 」が追加されました。名前から推測するのは難しいことではないため、最初（ minOccurs ）は、このシーケンスに、タイプ「 phone 」、「 text 」、「 date 」、および「 type 」の少なくとも1つの要素があることを報告しますが、次（ maxOccurs ）この属性は、シーケンスにそのような要素が最大で1つあることを宣言します。その結果、任意のデータのスキームを記述するとき、それらをセットアップするための最も幅広い選択肢が与えられます！

回路の2番目のブロックは、タイプMessageListの messageList要素を宣言します。 MessageListは少なくとも1つのメッセージ要素を含む複合型ですが、そのような要素の最大数は無制限です！

これについては、スキームに従ってLikBezが完了し、別のエキサイティングな冒険が待っていると仮定します。独自のWSDLを作成します。

4 WSDLを作成します

WSDLがWebサービスであることを覚えていますか？覚えておいてください！これを作成すると、小さなWebサービスが浮かび上がります。したがって、ハッキングしないことを提案します。

一般に、すべてが正しく機能するためには、正しいMIMEタイプのWSDLファイルをクライアントに転送する必要があります。これを行うには、それに応じてWebサーバーを構成する必要があります。つまり、拡張子が* .wsdlのファイルのMIMEタイプを次の行に設定する必要があります。

 application/wsdl+xml

しかし実際には、PHPを介して「 text / xml 」HTTPヘッダーを通常送信しました。

 header("Content-Type: text/xml; charset=utf-8");

そしてすべてがうまくいきました！

すぐに警告したいのですが、シンプルなWebサービスの説明は非常に印象的です。怖がらないでください。テキストの大部分は水を必要とするものであり、一度書けば、あるWebサービスから別のWebサービスに常にコピーできます。

WSDLはXMLであるため、最初の行でそれについて直接記述する必要があります。ファイルのルート要素は、常に「定義」と呼ばれる必要があります。

 <?xml version="1.0" encoding="utf-8"?> <definitions> </definitions>

通常、WSDLは4〜5個のメインブロックで構成されます。最初のブロックは、Webサービスの定義、つまりエントリポイントです。

 <?xml version="1.0" encoding="utf-8"?> <definitions> <!—  --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://localhost:80/smsservice.php" /> </port> </service> </definitions>

ここでは、「 SmsService 」というサービスがあることを示しています。原則として、WSDLファイル内のすべての名前は、任意の名前に変更できます。それらはまったく役割を果たしません。

その後、 SmsService Webサービスに「 SmsServicePort 」というエントリポイント（「ポート」）があることを発表します。このエントリポイントで、クライアントからサーバーへのすべての要求が送信されます。そして、「 address 」要素で、リクエストを受信するファイルハンドラへのリンクを示します。

Webサービスを決定し、そのエントリポイントを指定したら、サポートされている手順をそれにバインドする必要があります。

 <?xml version="1.0" encoding="utf-8"?> <definitions> <!—  - --> <binding name="SmsServiceBinding" type="tns:SmsServicePortType"> <soap:binding style=”rpc” transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="sendSms"> <soap:operation soapAction="" /> <input> <soap:body use="literal" /> </input> <output> <soap:body use="literal" /> </output> </operation> </binding> <!—  --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://localhost:80/smsservice.php" /> </port> </service> </definitions>

これを行うために、どの操作がどの形式で呼び出されるかをリストします。つまり SmsServicePortポートの場合、バインディングはSmsServiceBindingという名前で定義されます。この名前はrpc呼び出しタイプを持ち、トランスポート（トランスポート）プロトコルとしてHTTPを使用します。したがって、ここではHTTP経由でRPC呼び出しを行うことを示しました。その後、Webサービスでサポートされる手順（ operation ）について説明します。「 sendSms 」という1つの手順のみをサポートします。この手順により、すばらしいメッセージがサーバーに送信されます！手順が発表された後、データを送信する形式を指定する必要があります。この場合、標準のSOAPエンベロープが使用されることが示されています。

その後、プロシージャをメッセージにバインドする必要があります。

 <?xml version="1.0" encoding="utf-8"?> <definitions> <!—     --> <portType name="SmsServicePortType"> <operation name="sendSms"> <input message="tns:sendSmsRequest" /> <output message="tns:sendSmsResponse" /> </operation> </portType> <!—  - --> <binding name="SmsServiceBinding" type="tns:SmsServicePortType"> <soap:binding style=”rpc” transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="sendSms"> <soap:operation soapAction="" /> <input> <soap:body use="literal" /> </input> <output> <soap:body use="literal" /> </output> </operation> </binding> <!—   --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://localhost:80/smsservice.php" /> </port> </service> </definitions>

これを行うには、バインディングのタイプが「 SmsServicePortType 」であることを示し、同じタイプ名の「 portType 」要素で、プロシージャをメッセージにバインドすることを示します。そのため、着信メッセージ（クライアントからサーバーへ）は「 sendSmsRequest 」と呼ばれ、発信メッセージ（サーバーからクライアントへ）は「 sendSmsResponse 」と呼ばれます。 WSDLのすべての名前と同様に、着信メッセージと発信メッセージの名前は任意です。

ここで、メッセージ自体、つまり着信および発信：

 <?xml version="1.0" encoding="utf-8"?> <definitions> <!--   sendSms --> <message name="sendSmsRequest"> <part name="Request" element="tns:Request" /> </message> <message name="sendSmsResponse"> <part name="Response" element="tns:Response" /> </message> <!--     --> <portType name="SmsServicePortType"> <operation name="sendSms"> <input message="tns:sendSmsRequest" /> <output message="tns:sendSmsResponse" /> </operation> </portType> <!--   - --> <binding name="SmsServiceBinding" type="tns:SmsServicePortType"> <soap:binding style=”rpc” transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="sendSms"> <soap:operation soapAction="" /> <input> <soap:body use="literal" /> </input> <output> <soap:body use="literal" /> </output> </operation> </binding> <!--   --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://localhost:80/smsservice.php" /> </port> </service> </definitions>

これを行うには、それぞれsendSmsRequestおよびsendSmsResponseという名前のメッセージ要素を追加します。それらにおいて、エンベロープは入力で受信されるべきであり、その構造は「 リクエスト 」データ型に対応することを示します。その後、データタイプ「 Response 」を含むエンベロープがサーバーから返されます。

ここで少しする必要があります-これらのタイプの説明をWSDLファイルに追加してください！また、受信データと送信データはWSDLでどのように記述されていると思いますか？あなたは長い間すべてを理解しており、XMLスキーマの助けを借りてそれを自分自身に語ったと思います！そして、あなたは絶対に正しいでしょう！

 <?xml version="1.0" encoding="utf-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://localhost/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" name="SmsWsdl" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types> <xs:schema xmlns:tns="http://schemas.xmlsoap.org/wsdl/" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="http://localhost/"> <complexType name="Message"> <sequence> <element name="phone" type="string" minOccurs="1" maxOccurs="1" /> <element name="text" type="string" minOccurs="1" maxOccurs="1" /> <element name="date" type="dateTime" minOccurs="1" maxOccurs="1" /> <element name="type" type="decimal" minOccurs="1" maxOccurs="1" /> </sequence> </complexType> <complexType name="MessageList"> <sequence> <element minOccurs="1" maxOccurs="unbounded" name="message" type="Message"/> </sequence> </complexType> <element name="Request"> <element name="messageList" type="MessageList" /> </element> <element name="Response"> <complexType> <sequence> <element name="status" type="boolean" /> </sequence> </complexType> </element> </xs:schema> </types> <!--   sendSms --> <message name="sendSmsRequest"> <part name="Request" element="tns:Request" /> </message> <message name="sendSmsResponse"> <part name="Response" element="tns:Response" /> </message> <!--     --> <portType name="SmsServicePortType"> <operation name="sendSms"> <input message="tns:sendSmsRequest" /> <output message="tns:sendSmsResponse" /> </operation> </portType> <!--   - --> <binding name="SmsServiceBinding" type="tns:SmsServicePortType"> <soap:binding style=”rpc” transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="sendSms"> <soap:operation soapAction="" /> <input> <soap:body use="literal" /> </input> <output> <soap:body use="literal" /> </output> </operation> </binding> <!--   --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://localhost:80/smsservice.php" /> </port> </service> </definitions>

おめでとうございます！最初のWSDLが作成されました！そして、私たちは目標を達成するための一歩です。
次に、PHPが独自の分散アプリケーションを開発するために提供するものを扱います。

5最初のSOAPサーバー

SoapServer組み込みクラスを使用してPHPでSOAPサーバーを作成することを以前に書きました。それ以降のすべてのアクションが私のものと同様に発生するためには、PHPを少し調整する必要があります。より正確にするには、拡張機能「php-soap」がインストールされていることを確認する必要があります。 Webサーバーに配置する方法は、PHPの公式Webサイトで読むのが最適です（参考文献を参照）。

すべてをインストールして構成したら、ホスティングのルートフォルダーに次の内容のファイル「 smsservice.php 」を作成する必要があります。

 <?php /** * smsservice.php */ header("Content-Type: text/xml; charset=utf-8"); header('Cache-Control: no-store, no-cache'); header('Expires: '.date('r')); /** *  -    */ set_include_path(get_include_path() .PATH_SEPARATOR.'classes' .PATH_SEPARATOR.'objects'); /** *     */ const CONF_NAME = "config.ini"; /** **      */ function __autoload($class_name){ include $class_name.'.class.php'; } ini_set("soap.wsdl_cache_enabled", "0"); //   WSDL-   //  SOAP- $server = new SoapServer("http://{$_SERVER['HTTP_HOST']}/smsservice.wsdl.php"); //   $server->setClass("SoapSmsGateWay"); //  $server->handle();

ini_set関数の行の上にあるものは、説明する必要がないことを願っています。なぜならサーバーからクライアントに送信するHTTPヘッダーを決定し、環境が構成されます。「ini_set」の行では、WSDLファイルのキャッシュを無効にして、クライアントでの変更がすぐに有効になるようにします。

これでサーバーに来ました！ご覧のとおり、SOAPサーバー全体で必要なのは3行だけです！最初の行では、SoapServerオブジェクトの新しいインスタンスを作成し、WebサービスのWSDL記述のアドレスをコンストラクターに渡します。これで、「 smsservice.wsdl.php 」という名前のファイルのホスティングのルートに配置されることがわかりました。 2行目では、クライアントから受信したエンベロープを処理し、応答とともにエンベロープを返すためにプルするクラスをSOAPサーバーに指示します。ご想像のとおり、sendSmsメソッドのみを説明するのはこのクラスです。 3行目では、サーバーを起動します！これでサーバーは準備完了です！これで私たち全員を祝福します！

次に、WSDLファイルを作成する必要があります。これを行うには、前のセクションからその内容を単にコピーするか、自分自身に自由を与えて少し「テンプレート化」することができます。

 <?php /** * smsservice.wsdl.php */ header("Content-Type: text/xml; charset=utf-8"); echo "<?xml version=\"1.0\" encoding=\"utf-8\"?>"; ?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://<?=$_SERVER['HTTP_HOST']?>/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" name="SmsWsdl" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types> <xs:schema elementFormDefault="qualified" xmlns:tns="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://<?=$_SERVER['HTTP_HOST']?>/"> <xs:complexType name="Message"> <xs:sequence> <xs:element name="phone" type="xs:string" minOccurs="1" maxOccurs="1" /> <xs:element name="text" type="xs:string" minOccurs="1" maxOccurs="1" /> <xs:element name="date" type="xs:dateTime" minOccurs="1" maxOccurs="1" /> <xs:element name="type" type="xs:decimal" minOccurs="1" maxOccurs="1" /> </xs:sequence> </xs:complexType> <xs:complexType name="MessageList"> <xs:sequence> <xs:element name="message" type="Message" minOccurs="1" maxOccurs="unbounded" /> </xs:sequence> </xs:complexType> <xs:element name="Request"> <xs:complexType> <xs:sequence> <xs:element name="messageList" type="MessageList" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Response"> <xs:complexType> <xs:sequence> <xs:element name="status" type="xs:boolean" /> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> </types> <!--   sendSms --> <message name="sendSmsRequest"> <part name="Request" element="tns:Request" /> </message> <message name="sendSmsResponse"> <part name="Response" element="tns:Response" /> </message> <!--     --> <portType name="SmsServicePortType"> <operation name="sendSms"> <input message="tns:sendSmsRequest" /> <output message="tns:sendSmsResponse" /> </operation> </portType> <!--   - --> <binding name="SmsServiceBinding" type="tns:SmsServicePortType"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http" /> <operation name="sendSms"> <soap:operation soapAction="" /> <input> <soap:body use="literal" /> </input> <output> <soap:body use="literal" /> </output> </operation> </binding> <!--   --> <service name="SmsService"> <port name="SmsServicePort" binding="tns:SmsServiceBinding"> <soap:address location="http://<?=$_SERVER['HTTP_HOST']?>/smsservice.php" /> </port> </service> </definitions>

この段階では、結果のサーバーは完全に私たちに合うはずです。到着したエンベロープをログに記録し、着信データを静かに分析できます。サーバーで何かを受信できるようにするには、クライアントが必要です。やってみましょう！

6途中のSOAPクライアント

まず、クライアントを書き込むファイルを作成する必要があります。いつものように、ホストのルートに作成し、「 client.php 」と呼び、内部に次のように記述します。

 <?php /** * /client.php */ header("Content-Type: text/html; charset=utf-8"); header('Cache-Control: no-store, no-cache'); header('Expires: '.date('r')); /** *  -    */ set_include_path(get_include_path() .PATH_SEPARATOR.'classes' .PATH_SEPARATOR.'objects'); /** **      */ function __autoload($class_name){ include $class_name.'.class.php'; } ini_set('display_errors', 1); error_reporting(E_ALL & ~E_NOTICE); //   class Message{ public $phone; public $text; public $date; public $type; } class MessageList{ public $message; } class Request{ public $messageList; } //       $req = new Request(); $req->messageList = new MessageList(); $req->messageList->message = new Message(); $req->messageList->message->phone = '79871234567'; $req->messageList->message->text = '  1'; $req->messageList->message->date = '2013-07-21T15:00:00.26'; $req->messageList->message->type = 15; $client = new SoapClient( "http://{$_SERVER['HTTP_HOST']}/smsservice.wsdl.php", array( 'soap_version' => SOAP_1_2)); var_dump($client->sendSms($req));

オブジェクトについて説明します。 WSDLを記述したときに、サーバーに入るエンベロープの3つのエンティティ、 Request 、 MessageList 、およびMessageが記述されました。したがって、 Request 、 MessageList、およびMessageクラスは、PHPスクリプトのこれらのエンティティを反映しています。

オブジェクトを定義したら、サーバーに送信するオブジェクト（ $ req ）を作成する必要があります。その後、私たちのために2つの最も大切な行が来ます！ SOAPクライアント！信じられないかもしれませんが、これはクライアントからサーバーへのメッセージの送信を開始し、サーバーがメッセージを正常に受信して処理できるようにするのに十分です！最初の例では、SoapClientクラスのインスタンスを作成し、WSDLファイルの場所アドレスをコンストラクターに渡します。パラメーターでは、SOAPプロトコルバージョン1.2を使用して作業することを明示的に示します。次の行では、 $ clientオブジェクトのsendSmsメソッドを呼び出し、すぐに結果をブラウザーに出力します。
実行して、最終的に得たものを見てみましょう！

次のオブジェクトがサーバーから返されました：

 object(stdClass)[5] public 'status' => boolean true

そしてこれは素晴らしい、なぜならこれで、サーバーが正常に機能しているだけでなく機能していることが確実にわかりましたが、クライアントに値を返すこともできます！

それでは、サーバー側で慎重に保持するログを見てみましょう。最初の部分では、サーバーに送られた生データを確認します。

 <?xml version="1.0" encoding="UTF-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="http://sms-service/"> <env:Body> <ns1:Request> <ns1:messageList> <message> <phone>79871234567</phone> <text>  1</text> <date>2013-07-21T15:00:00.26</date> <type>15</type> </message> </ns1:messageList> </ns1:Request> </env:Body> </env:Envelope>

これが封筒です。これで、どのように見えるかがわかりました！しかし、絶えず彼を賞賛することは私たちにとって興味深いことではないので、ログファイルからオブジェクトをデシリアライズし、すべてがうまくいくかどうかを確認しましょう。

 object(stdClass)[4] public 'messageList' => object(stdClass)[5] public 'message' => object(stdClass)[6] public 'phone' => string '79871234567' (length=11) public 'text' => string '  1' (length=37) public 'date' => string '2013-07-21T15:00:00.26' (length=22) public 'type' => string '15' (length=2)

ご覧のとおり、オブジェクトは正しくデシリアライズされました。これで私たち全員を祝福したいと思います。それからもっと面白いものが待っています！つまり、1つのSMSメッセージではなく、サーバー全体にクライアントを送信します（より正確には3つ）。

7複雑なオブジェクトを送信します

1つのパッケージで大量のメッセージをサーバーに転送する方法を考えてみましょう。おそらく最も簡単な方法は、messageList要素内で配列を整理することです。やってみましょう：

 //       $req = new Request(); $req->messageList = new MessageList(); $msg1 = new Message(); $msg1->phone = '79871234567'; $msg1->text = '  1'; $msg1->date = '2013-07-21T15:00:00.26'; $msg1->type = 15; $msg2 = new Message(); $msg2->phone = '79871234567'; $msg2->text = '  2'; $msg2->date = '2014-08-22T16:01:10'; $msg2->type = 16; $msg3 = new Message(); $msg3->phone = '79871234567'; $msg3->text = '  3'; $msg3->date = '2014-08-22T16:01:10'; $msg3->type = 17; $req->messageList->message[] = $msg1; $req->messageList->message[] = $msg2; $req->messageList->message[] = $msg3;

私たちのログは、次のパッケージがクライアントから来たと言っています：

 <?xml version="1.0" encoding="UTF-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:enc="http://www.w3.org/2003/05/soap-encoding" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://sms-service/"> <env:Body> <ns1:Request> <ns1:messageList> <message> <SOAP-ENC:Struct> <phone>79871234567</phone> <text>  1</text> <date>2013-07-21T15:00:00.26</date> <type>15</type> </SOAP-ENC:Struct> <SOAP-ENC:Struct> <phone>79871234567</phone> <text>  2</text> <date>2014-08-22T16:01:10</date> <type>16</type> </SOAP-ENC:Struct> <SOAP-ENC:Struct> <phone>79871234567</phone> <text>  3</text> <date>2014-08-22T16:01:10</date> <type>17</type> </SOAP-ENC:Struct> </message> </ns1:messageList> </ns1:Request> </env:Body> </env:Envelope>

, ? , .. , , . , sms- XML , – message , Struct . sendSms :

 object(stdClass)[6] public 'messageList' => object(stdClass)[7] public 'message' => object(stdClass)[8] public 'Struct' => array (size=3) 0 => object(stdClass)[9] public 'phone' => string '79871234567' (length=11) public 'text' => string '  1' (length=37) public 'date' => string '2013-07-21T15:00:00.26' (length=22) public 'type' => string '15' (length=2) 1 => object(stdClass)[10] public 'phone' => string '79871234567' (length=11) public 'text' => string '  2' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '16' (length=2) 2 => object(stdClass)[11] public 'phone' => string '79871234567' (length=11) public 'text' => string '  3' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '17' (length=2)

? , – « ?». :

 $req->messageList->message = (object)$req->messageList->message;

, :

 <?xml version="1.0" encoding="UTF-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="http://sms-service/"> <env:Body> <ns1:Request> <ns1:messageList> <message> <BOGUS> <phone>79871234567</phone> <text>  1</text> <date>2013-07-21T15:00:00.26</date> <type>15</type> </BOGUS> <BOGUS> <phone>79871234567</phone> <text>  2</text> <date>2014-08-22T16:01:10</date> <type>16</type> </BOGUS> <BOGUS> <phone>79871234567</phone> <text>  3</text> <date>2014-08-22T16:01:10</date> <type>17</type> </BOGUS> </message> </ns1:messageList> </ns1:Request> </env:Body> </env:Envelope>

sendSms :

 object(stdClass)[7] public 'messageList' => object(stdClass)[8] public 'message' => object(stdClass)[9] public 'BOGUS' => array (size=3) 0 => object(stdClass)[10] public 'phone' => string '79871234567' (length=11) public 'text' => string '  1' (length=37) public 'date' => string '2013-07-21T15:00:00.26' (length=22) public 'type' => string '15' (length=2) 1 => object(stdClass)[11] public 'phone' => string '79871234567' (length=11) public 'text' => string '  2' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '16' (length=2) 2 => object(stdClass)[12] public 'phone' => string '79871234567' (length=11) public 'text' => string '  3' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '17' (length=2)

, « – » (). BOGUS , Struct – ! , message . , . , – . , , message BOGUS ! :

 //       $req = new Request(); $msg1 = new Message(); $msg1->phone = '79871234567'; $msg1->text = '  1'; $msg1->date = '2013-07-21T15:00:00.26'; $msg1->type = 15; $msg2 = new Message(); $msg2->phone = '79871234567'; $msg2->text = '  2'; $msg2->date = '2014-08-22T16:01:10'; $msg2->type = 16; $msg3 = new Message(); $msg3->phone = '79871234567'; $msg3->text = '  3'; $msg3->date = '2014-08-22T16:01:10'; $msg3->type = 17; $req->messageList[] = $msg1; $req->messageList[] = $msg2; $req->messageList[] = $msg3; $req->messageList = (object)$req->messageList;

? :

 <?xml version="1.0" encoding="UTF-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="http://sms-service/"> <env:Body> <ns1:Request> <ns1:messageList> <BOGUS> <phone>79871234567</phone> <text>  1</text> <date>2013-07-21T15:00:00.26</date> <type>15</type> </BOGUS> <BOGUS> <phone>79871234567</phone> <text>  2</text> <date>2014-08-22T16:01:10</date> <type>16</type> </BOGUS> <BOGUS> <phone>79871234567</phone> <text>  3</text> <date>2014-08-22T16:01:10</date> <type>17</type> </BOGUS> </ns1:messageList> </ns1:Request> </env:Body> </env:Envelope>

はい、奇跡は起こりませんでした！ボーガス -勝てない！この場合にsendSmsに到達したオブジェクトは次のようになります。

 object(stdClass)[6] public 'messageList' => object(stdClass)[7] public 'BOGUS' => array (size=3) 0 => object(stdClass)[8] public 'phone' => string '79871234567' (length=11) public 'text' => string '  1' (length=37) public 'date' => string '2013-07-21T15:00:00.26' (length=22) public 'type' => string '15' (length=2) 1 => object(stdClass)[9] public 'phone' => string '79871234567' (length=11) public 'text' => string '  2' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '16' (length=2) 2 => object(stdClass)[10] public 'phone' => string '79871234567' (length=11) public 'text' => string '  3' (length=37) public 'date' => string '2014-08-22T16:01:10' (length=19) public 'type' => string '17' (length=2)

彼らが言うように-「ほぼ」！この（少し悲しい）メモで、私は静かにまとめて、自分のために結論を出すことを提案します。

8結論

ついにここに来ました！今何ができるかを決めましょう：

Webサービスに必要なWSDLファイルを作成できます。
問題なく、SOAPを介してサーバーと通信できる独自のクライアントを作成できます。
SOAPを介して外部と通信する独自のサーバーを作成できます。
クライアントから同じタイプのオブジェクトの配列をサーバーに送信できます（いくつかの制限があります）。

, :

SoapClient XML;
XML Struct ;
XML BOGUS ;
BOGUS Struct - , ( namespace' XML );
, SoapServer XML- (, ).

9

www.w3.org/XML/Schema – XML-
www.w3.org/TR/soap – SOAP
ru.wikipedia.org/wiki/Remote_Procedure_Call – RPC
ru.wikipedia.org/wiki/REST – REST
ru.wikipedia.org/wiki/XML – XML
ru.wikipedia.org/wiki/XML_Schema – XML-
ru.wikipedia.org/wiki/WSDL – WSDL
www.php.net/manual/ru/book.soap.php – SOAP PHP
github.com/hats/soap-sms-service –

PS SOAP , SoapServer SoapClient. , SOAP PHP, , :)

PPS Mikaz
ArrayObject SoapVar .

:

 $req = new Request(); $req->messageList = new \ArrayObject(); $msg1 = new Message(); $msg1->phone = '79871234567'; $msg1->text = '  1'; $msg1->date = '2013-07-21T15:00:00.26'; $msg1->type = 15; $soap_msg1 = new \SoapVar($msg1, SOAP_ENC_OBJECT, null, null, 'Message'); $msg2 = new Message(); $msg2->phone = '79871234567'; $msg2->text = '  2'; $msg2->date = '2014-08-22T16:01:10'; $msg2->type = 16; $soap_msg2 = new \SoapVar($msg2, SOAP_ENC_OBJECT, null, null, 'Message'); $msg3 = new Message(); $msg3->phone = '79871234567'; $msg3->text = '  3'; $msg3->date = '2014-08-22T16:01:10'; $msg3->type = 17; $soap_msg3 = new \SoapVar($msg3, SOAP_ENC_OBJECT, null, null, 'Message'); $req->messageList->append($soap_msg1); $req->messageList->append($soap_msg2); $req->messageList->append($soap_msg3);

SOAPクライアントサーバーアプリケーションをPHPで記述します