apache::soap(3)
NAME
Apache::SOAP - mod_perl-based SOAP server with minimum
configuration
SYNOPSIS
httpd.conf (Location), directory-based access
<Location /mod_soap>
SetHandler perl-script
PerlHandler Apache::SOAP
PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
PerlSetVar options "compress_threshold => 10000"
</Location>
httpd.conf (Files), file-based access
<FilesMatch ".soap$">
SetHandler perl-script
PerlHandler Apache::SOAP
PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
PerlSetVar options "compress_threshold => 10000"
</FilesMatch>
.htaccess, directory-based access
SetHandler perl-script
PerlHandler Apache::SOAP
PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
PerlSetVar options "compress_threshold => 10000"
DESCRIPTION
This Apache Perl module provides the ability to add sup
port for SOAP (Simple Object Access Protocol) protocol
with easy configuration (either in .conf or in .htaccess
file). This functionality should give you lightweight
option for hosting SOAP services and greatly simplify con
figuration aspects. This module inherites functionality
from SOAP::Transport::HTTP::Apache component of SOAP::Lite
module.
CONFIGURATION
The module can be placed in <Location>, <Directory>,
<Files>, <FilesMatch> directives in main server configura
tion areas or directly in .htaccess file.
All parameters should be quoted and can be separated with
commas or spaces for lists ("a, b, c") and with 'wide
arrows' and commas for hash parameters ("key1 => value1,
key2 => value2").
All options that you can find in SOAP::Trans
port::HTTP::Apache component are available for configura
tion. Here is the description of most important ones.
- dispatch_to (LIST)
- Specifies path to directory that contains Perl modules
you'd like to give access to, or just list of modules
(for preloaded modules).
PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method" - options (HASH)
Specifies list of options for your module, for example
threshold for compression. Future versions will sup
port more options. See SOAP::Transport::HTTP
documentation for other options.
PerlSetVar options "compress_threshold => 10000"
DEPENDENCIES
SOAP::Lite
mod_perl
SEE ALSO
- SOAP::Transport::HTTP::Apache for implementation details,
SOAP::Lite for general information, and
F<examples/server/mod_soap.htaccess> for .htaccess exam - ple
COPYRIGHT
Copyright (C) 2000-2001 Paul Kulchenko. All rights
reserved.
This library is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
AUTHOR
- Paul Kulchenko (paulclinger@yahoo.com)