# man > Apache::SOAP(3pm)

---
type: CommandReference
command: Apache::SOAP
mode: perldoc
section: 3pm
source: perldoc
---

## Quick Reference
- `PerlSetVar dispatch_to "/path, Module::Name"` — Specify accessible modules/directories
- `PerlSetVar options "compress_threshold => 10000"` — Set SOAP transport options
- `SetHandler perl-script; PerlHandler Apache::SOAP` — Activate SOAP handler
- `<Location /path>` / `<FilesMatch "\.soap$">` — Bind handler to directory or file pattern
- `.htaccess` based configuration — Use same directives in per-directory context

## Name
mod_perl-based SOAP server with minimum configuration

## Synopsis
apache
<Location /path>
  SetHandler perl-script
  PerlHandler Apache::SOAP
  PerlSetVar dispatch_to "Module::List, /path/to/modules"
  PerlSetVar options "key1 => value1, key2 => value2"
</Location>
## Options
All options from [SOAP::Transport::HTTP::Apache](http://localhost/phpMan.php/perldoc/SOAP%3A%3ATransport%3A%3AHTTP%3A%3AApache/markdown) are available. Key parameters:

- `dispatch_to (LIST)` — Comma- or space-separated list of Perl module names and/or directories containing deployed modules.
- `options (HASH)` — Hash of transport options, e.g., `compress_threshold => 10000`. Format: `"key1 => value1, key2 => value2"`.

## Examples

### Directory-based access (Location)
apache
<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>
### File-based access (FilesMatch)
apache
<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>
### Per-directory `.htaccess`
apache
SetHandler perl-script
PerlHandler Apache::SOAP
PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
PerlSetVar options "compress_threshold => 10000"
## Methods

- `server()` — Returns the server object. E.g., `my $server = Apache::SOAP->server()`. (The original documentation snippet erroneously shows `Apache::XMLRPC::Lite->server()`.)
- `handle()` — Request handler called by Apache.

## Dependencies
- [SOAP::Lite](http://localhost/phpMan.php/perldoc/SOAP%3A%3ALite/markdown)
- mod_perl

## See Also
- [SOAP::Transport::HTTP::Apache](http://localhost/phpMan.php/perldoc/SOAP%3A%3ATransport%3A%3AHTTP%3A%3AApache/markdown) for implementation details
- [SOAP::Lite](http://localhost/phpMan.php/perldoc/SOAP%3A%3ALite/markdown) for general information
- `examples/server/mod_soap.htaccess` for .htaccess example