Chapter 4. Files in the distribution

lib/xmlrpc.inc

the XML-RPC classes. include() this in your PHP files to use the classes.

lib/xmlrpcs.inc

the XML-RPC server class. include() this in addition to xmlrpc.inc to get server functionality

lib/xmlrpc_wrappers.inc

helper functions to "automagically" convert plain php functions to xmlrpc services and vice versa

demo/server/proxy.php

a sample server implementing xmlrpc proxy functionality.

demo/server/server.php

a sample server hosting various demo functions, as well as a full suite of functions used for interoperability testing. It is used by testsuite.php (see below) for unit testing the library, and is not to be copied literally into your production servers

demo/client/client.php, demo/client/agesort.php, demo/client/which.php

client code to exercise some of the functions in server.php, including the interopEchoTests.whichToolkit method.

demo/client/wrap.php

client code to illustrate 'wrapping' of remote methods into php functions.

demo/client/introspect.php

client code to illustrate usage of introspection capabilities offered by server.php.

demo/client/mail.php

client code to illustrate usage of an xmlrpc-to-email gateway using Dave Winer's XML-RPC server at userland.com.

demo/client/zopetest.php

example client code that queries an xmlrpc server built in Zope.

demo/vardemo.php

examples of how to construct xmlrpcval types

demo/demo1.txt, demo/demo2.txt, demo/demo3.txt

XML-RPC responses captured in a file for testing purposes (you can use these to test the xmlrpcmsg->parseResponse() method).

demo/server/discuss.php, demo/client/comment.php

Software used in the PHP chapter of The Jellyfish Book to provide a comment server and allow the attachment of comments to stories from Meerkat's data store.

test/testsuite.php, test/parse_args.php

A unit test suite for this software package. If you do development on this software, please consider submitting tests for this suite.

test/benchmark.php

A (very limited) benchmarking suite for this software package. If you do development on this software, please consider submitting benchmarks for this suite.

test/phpunit.php, test/PHPUnit/*.php

An (incomplete) version PEAR's unit test framework for PHP. The complete package can be found at http://pear.php.net/package/PHPUnit

test/verify_compat.php

Script designed to help the user to verify the level of compatibility of the library with the current php install

extras/test.pl, extras/test.py

Perl and Python programs to exercise server.php to test that some of the methods work.

extras/workspace.testPhpServer.fttb

Frontier scripts to exercise the demo server. Thanks to Dave Winer for permission to include these. See Dave's announcement of these.

extras/rsakey.pem

A test certificate key for the SSL support, which can be used to generate dummy certificates. It has the passphrase "test."