Error with documentation example

Discussion:

Yannick

2008-07-26 23:24:09 UTC

Hi there,

I'm currently taking my first steps with SCA-SDO following the example
given here:

http://www.osoa.org/display/PHP/SCA+Documentation#SCADocumentation-2.5

I am using an Ubuntu 8.04 system ad I downloaded SCA_SDO using the
PECL command line interface.
Now I'm sure I'm going to find the problem soon, but as the
documentation, as it is, is leading me to a problem and obviously I
can't create and account to edit that page, I wanted to mention it.

When I try getting the WSDL for that page, I get a (double) error
message:

[Sat Jul 26 11:58:27 2008] [error] [client 127.0.0.1] PHP Warning:
SCA_Binding_Factory::require(SCA/Bindings/ws/RequestTester.php) [<a
href='function.SCA-Binding-Factory-require'>function.SCA-Binding-
Factory-require</a>]: failed to open stream: No such file or directory
in /usr/share/php/SCA/SCA_BindingFactory.php on line 68
[Sat Jul 26 11:58:27 2008] [error] [client 127.0.0.1] PHP Fatal
error: SCA_Binding_Factory::require() [<a
href='function.require'>function.require</a>]: Failed opening required
'SCA/Bindings/ws/RequestTester.php' (include_path='.:/usr/share/php:/
usr/share/pear') in /usr/share/php/SCA/SCA_BindingFactory.php on line
68

Looking into my /usr/share/php/SCA/ directory, I have:

/usr/share/php/SCA/Bindings$ ls
atom jsonrpc message restrpc tuscany
ebaysoap local restresource soap xmlrpc

So, no directory called "ws/". I guess specifying in the given example
which type of service I want might help, but in the meantime the
example is leading straight to an error, which is confusing for
newcomers.

Cheers,

Yannick

Yannick

2008-07-27 22:39:07 UTC

Permalink

Like I said, finding the problem was not difficult nor long, but it's
still confusing that there is no explanation of what "ws" could be
replaced by in @binding.ws. Of course, replacing it by @binding.soap
worked immediately.
However, I tried to change it to @binding.restrpc and that,
apparently, brings me back to the initial state (blank page); but this
time I get no error report.
Changing it back to @binding.soap doesn't work.

Yannick

Post by Yannick
Hi there,
I'm currently taking my first steps with SCA-SDO following the example
http://www.osoa.org/display/PHP/SCA+Documentation#SCADocumentation-2.5
I am using an Ubuntu 8.04 system ad I downloaded SCA_SDO using the
PECL command line interface.
Now I'm sure I'm going to find the problem soon, but as the
documentation, as it is, is leading me to a problem and obviously I
can't create and account to edit that page, I wanted to mention it.
When I try getting the WSDL for that page, I get a (double) error
SCA_Binding_Factory::require(SCA/Bindings/ws/RequestTester.php) [<a
href='function.SCA-Binding-Factory-require'>function.SCA-Binding-
Factory-require</a>]: failed to open stream: No such file or directory
in /usr/share/php/SCA/SCA_BindingFactory.php on line 68
[Sat Jul 26 11:58:27 2008] [error] [client 127.0.0.1] PHP Fatal
error: SCA_Binding_Factory::require() [<a
href='function.require'>function.require</a>]: Failed opening required
'SCA/Bindings/ws/RequestTester.php' (include_path='.:/usr/share/php:/
usr/share/pear') in /usr/share/php/SCA/SCA_BindingFactory.php on line
68
/usr/share/php/SCA/Bindings$ ls
atom jsonrpc message restrpc tuscany
ebaysoap local restresource soap xmlrpc
So, no directory called "ws/". I guess specifying in the given example
which type of service I want might help, but in the meantime the
example is leading straight to an error, which is confusing for
newcomers.
Cheers,
Yannick

Yannick

2008-07-27 23:00:07 UTC

Permalink

Sorry, @binding.soap definitely works. I've been trying all the other
types (atom, jsonrpc, message, restrpc, tuscany, ebaysoap, local,
restresource, xmlrpc) but none of these generate a wsdl, even though
they don't generate any error message either.
Is that due to something proper to each of these other web services
types?

Yannick

Post by Yannick
Like I said, finding the problem was not difficult nor long, but it's
still confusing that there is no explanation of what "ws" could be
worked immediately.
apparently, brings me back to the initial state (blank page); but this
time I get no error report.
Yannick

Graham Charters

2008-07-29 07:21:49 UTC

Permalink

Hi Yannick,

Thanks for pointing out the documentation problem on osoa.org. I'll
try to fix that shortly.

Dalibor is correct that WSDL is only generated for binding.soap.
Other bindings will generate their own kinds of service descriptions
where appropriate. For example, binding.jsonrpc with generate a
service method description if you add ?smd.

Regards, Graham.

Correct. WSDL only gets created for SOAP services AFAIK.
dali
-----Original Message-----
Sent: Mon 2008-07-28 11:00
To: phpsoa
Subject: [phpsoa] Re: Error with documentation example
types (atom, jsonrpc, message, restrpc, tuscany, ebaysoap, local,
restresource, xmlrpc) but none of these generate a wsdl, even though
they don't generate any error message either.
Is that due to something proper to each of these other web services
types?
Yannick

winmail.dat
5KDownload

Matthew Peters

2008-07-29 10:03:36 UTC

Permalink

I just went through the page and changed all the binding.ws (and a
couple of binding.wsdl) to binding.soap.

I also sprinkled a warning that the most up to date documentation is
on php.net through the document:

|| _The most up to date documentation is to be found on the php.net
site, at [http://www.php.net/manual/en/book.sca.php] for example_ ||

Matthew

Post by Graham Charters
Hi Yannick,
Thanks for pointing out the documentation problem on osoa.org. I'll
try to fix that shortly.
Dalibor is correct that WSDL is only generated for binding.soap.
Other bindings will generate their own kinds of service descriptions
where appropriate. For example, binding.jsonrpc with generate a
service method description if you add ?smd.
Regards, Graham.

winmail.dat
5KDownload

simonslaws-gM/Ye1E23mwN+

2008-07-30 09:37:30 UTC

Permalink

Post by Graham Charters
Thanks

Hi Matthew,
Thanks for making these changes. I was going to, but got derailed by
the fact that the first ones are in images. I see these haven't been
changed. I think Simon Laws created these and I don't have the
originals. If we can't get the originals we'll need to recreate them,
or remove the images.
Regards, Graham.

Post by Matthew Peters
I just went through the page and changed all the binding.ws (and a
couple of binding.wsdl) to binding.soap.
I also sprinkled a warning that the most up to date documentation is
|| _The most up to date documentation is to be found on the php.net
site, at [http://www.php.net/manual/en/book.sca.php] for example_ ||
Matthew

winmail.dat
5KDownload

I'm sure I have those images somewhere but I've go a new laptop
recently so I'll have to drag them off the backup. Bear with me.

Simon