Thursday, November 17, 2005

 

I'm about to stab PHP in the face

NuSOAP and PEAR SOAP are both pretty popular for SOAP clients and to a lesser extent SOAP servers. NuSOAP has been around for 4 years, and PEAR SOAP at least 3 (based on the NuSOAP code). So in four years time, WHY is this API still largely undocumented! PEAR's lack of documentation for SOAP is completely inexcusable. The docs generated from PHPDocumenter list each class and their members, but the list ends with the valid parameters and maybe a one sentence description. What the hell guys?

PEAR SOAP has a couple of examples included, and NuSOAP has a bunch of examples and a tutorial, but I would really like to understand what some of these parameters mean. Perl's SOAP::Lite is nothing if not well documented. I may be lazy but if this SOAP server isn't fast to code, I don't have time to do it. I can say one thing - if I contribute to either PHP project it will be documentation.

I do want to mention that PEAR SOAP looks very, very cool. The server example seems to show a server method which points to an entire class. The class winds up published in SOAP and WSDL. That sounds nearly as easy as a C# .NET SOAP server.

Comments: Post a Comment

Links to this post:

Create a Link



<< Home

This page is powered by Blogger. Isn't yours?