README
1#
2# Filename: README
3#
4# $Id: README,v 1.3 2004/10/26 15:26:47 byrnereese Exp $
5
6SOAP::Lite for Perl is a collection of Perl modules which provides a simple
7and lightweight interface to the Simple Object Access Protocol (SOAP) both
8on client and server side.
9
10This version of SOAP::Lite supports a subset of the SOAP 1.1 specification
11and has initial support for SOAP 1.2 specification.
12See http://www.w3.org/TR/SOAP for details.
13
14SUPPORTED PLATFORMS
15
16This library has been tested by the author with Perl versions 5.005
17and 5.6.0 on different platforms: Windows 98/2K, Solaris 2.6, Linux 2.2.
18Should run everywhere where Perl 5.004 or later runs.
19
20PREREQUISITES
21
22Some modules within this package depend on other packages that are
23distributed separately from Perl. It supposes that you have the
24following distributions installed before you install SOAP::Lite:
25
26 XML::Parser
27 MIME::Base64
28 URI
29 libwww-perl
30
31Following modules will be loaded on demand only, and are considered optional:
32
33 Crypt::SSLeay HTTPS/SSL support
34 Apache mod_perl server implementation (included with mod_perl)
35 Net::POP3 POP3 server implementation
36 MIME::Lite SMTP client implementation
37 IO::File FTP client and IO server
38 Net::FTP FTP client
39 MQSeries MQSeries transport
40 Net::Jabber Jabber transport
41 FCGI FastCGI server implementation
42 IO::Socket::SSL SSL support for TCP transport
43 MIME::Tools MIME attachment support
44 DIME::Tools DIME attachment support
45 Compress::Zlib HTTP compression support
46
47These modules should be available from CPAN (http://search.cpan.org/).
48
49INSTALLATION ON UNIX
50
51You install SOAP::Lite as you would install any perl module library,
52by running these commands:
53
54If you have CPAN.pm installed and are connected to the Internet
55
56 > perl -MCPAN -e 'install SOAP::Lite'
57
58From the command line, try the following:
59
60 > perl Makefile.PL
61 > make
62 > make test
63 > make install
64
65INSTALLATION ON WIN32 PLATFORMS
66
67 > perl Makefile.PL
68 > nmake
69 > nmake test
70 > nmake install
71
72ACTIVESTATE USERS
73
74It is important that the same version of Perl is used to build the module, as
75used to run the module. Otherwise, you may experience page faults in some
76instances. Some people have found the following thread helpful in resolving
77this:
78
79http://groups.yahoo.com/group/soaplite/message/1371.
80
81If this does not help, you may consider trying the following:
82
83Build Lite.dll and perlapp using the same distribution. You can build Lite.dll
84using the make-com-minimal and make-com-standalone batch files (found in
85the "examples/COM/" directory of the SOAP-Lite distribution package).
86
87DOCUMENTATION
88
89See lib/SOAP/Lite.pm for an overview of the library. Documentation is
90included in modules and scripts. These are normally converted to manual
91pages and installed as part of the "make install" process. You should
92also be able to use the 'perldoc' utility to extract and read
93documentation from the module files directly.
94
95SUPPORT
96
97Questions about how to use this library should be directed to the SOAP
98mailing list (http://discuss.develop.com/soap.html). Bug reports and
99suggestions for improvements can also be sent there. This mailing list is
100also the place for general discussions and development of the SOAP protocol
101itself.
102
103Feel free to send mail directly to author with your comments, suggestions,
104bug reports and complaints.
105
106CHANGE HISTORY and RELEASE NOTES
107
108For extensive list of changes to the SOAP::Lite module consult the "Changes"
109file.
110
111Also, consult ReleaseNotes.txt for a list of known issues and common problems
112people have reported.
113
114ACKNOWLEDGEMENTS
115
116Special thanks to Randy J. Ray, author of I<Programming Web Services with Perl>,
117who has contributed greatly to the documentation effort of SOAP::Lite.
118
119Special thanks to O'Reilly publishing which has graciously allowed SOAP::Lite
120to republish and redistribute the SOAP::Lite reference manual found in Appendix B
121of I<Programming Web Services with Perl>.
122
123And special gratitude to all the developers who have contributed patches, ideas,
124time, energy, and help in a million different forms to the development of this
125software.
126
127COPYRIGHT
128
129Copyright (C) 2000-2004 Paul Kulchenko. All rights reserved.
130
131This library is free software; you can redistribute it and/or modify
132it under the same terms as Perl itself.
133
134SOAP::Lite's documentation is made available under the Creative Commons
135Attribution-NoDerivs 2.0 license.
136http://creativecommons.org/licenses/by-nd/2.0/
137
138AUTHORS
139
140Paul Kulchenko (paulclinger@yahoo.com)
141Byrne Reese (byrne@majordojo.com)
142