Modifications to SOAP web services entry

[weaverryan]

I believe that two changes should be made to the SOAP web services entry:

• Create a separate class (and suggest making it a service) that's actually used as the "client" class by SOAP. In other words, using the controller itself as the "consumable SOAP object" is not a good practice. You should instead have a separate service that's used. We should show this.
• I think we might also mention Zend Framework's SOAP library. It automatically generates your WSDL and is, in my opinion, much better than using PHP's SOAP library directly.

[RogerWebb]

I haven't used Zend's SOAP library, but I might as well learn it. I have some free time this weekend and would like to try to take a stab at fixing the WebServiceBundle. It uses Zend SOAP, so maybe I can come up with an example for the cookbook while I'm at it.

For the client, I can get rid of the NuSOAP client example and replace it with one using the PHP SOAP extension (and I can configure it as a service as well).

As for the server example, I can move the "hello" function into it's own class and pass an instance of it to "SoapServer::setObject()".

If you think these changes fit the bill, let me know and I'll get something together over the next few days.

Roger

PS: Thank you for taking the time to help me get up and running with this. This (the last few commits here) has been my first time committing to an OS project and I've had to learn rst, git and the like. It's been fun. I'm looking forward to hooking up some code next. So thanks again.

[stof]

There is now a bundle integrating Zend\Soap: https://github.com/BeSimple/BeSimpleSoapBundle

[RogerWebb]

I like the idea of including a recipe for an existing bundle that handles web services. I figure, having a "Web Service" section of the cookbook now, we could create a recipe using Zend\Soap, PHP SOAP Extension, the Bundle stof mentioned and I've also set up nusoap in a similar fashion.

Looking forward to the 2.0 release. I'm giving a presentation to Como Rich Web (our local web dev meetup) on Symfony2 and Doctrine. It was pre-slated already, so we'll be celebrating a bit early!

Sorry for the delay getting the revisions updated. I'm fully booked the next couple of days, but I'll get it done this weekend at the latest.

Roger

[RogerWebb]

and the example I use for the presentation is styled in the way Ryan mentioned :) Sorry for the double post.

[weaverryan]

Hey Roger!

Very cool about the presentation - do us proud! If you need some Symfony2 presentation inspiration, I have a few up on my slideshare page fwiw.

About the cookbook entries, I'd recommend the following:

• Definitely abstract the actual SOAP client class into its own class as you had mentioned
• We should just mention the ZF SOAP library, you can tell exactly what parts it will help you out with. For example, The ZF SOAP library would generate the WDSL for you. If it's easy enough, you might show a quick example of it in use, but the point is just to make people aware of their options
• I might also mention the BeSimpleSoapBundle, but I haven't looked at this bundle yet.

I think what you have now is really solid - shows the fundamentals of catching the SOAP handler's response and controlling it. Add a few other references and I think we're really solid :). I think overall, we should just have one SOAP entry with the various options.

Cheers!

[RogerWebb]

Hey Ryan,

Presentation went well. It was a bit tight on time as I had to cover doctrine first, then SF2, but we got through it all. It was a lively meetup. I happened upon another Symfony developer (from carfax I think, that's where the meetup was). So that makes 2 of us in Columbia anyway :)

I committed some changes, creating a HelloService class and service definition. I haven't had a chance to play with the ZF SOAP library yet. I went through some documentation and once I create a working example, I'll whip something up for the chapter.

Thanks!

[borcho]

Is the current client code example correct? $client = new soapclient('http://example.com/app.php/soap?wsdl', true); class soapclient returns an error without the backslash in front. If so, please fix it or add a clarification.

[weaverryan]

Possibly, what do you mean by "without the backslash in front"?

[borcho]

$client = new soapclient('http://example.com/app.php/soap?wsdl', true); I get a class not found error in controller namespace unless I put a backslash \ in front of soapclient object: $client = new \soapclient('http://example.com/app.php/soap?wsdl', true);

---

From: weaverryan reply@reply.github.com To: boris_nenchev@yahoo.com Sent: Saturday, August 6, 2011 9:39 AM Subject: Re: [symfony-docs] Modifications to SOAP web services entry (#567)

Possibly, what do you mean by "without the backslash in front"?

Reply to this email directly or view it on GitHub: https://github.com/symfony/symfony-docs/issues/567#issuecomment-1741923