view release on metacpan or  search on metacpan

lib/Any/Daemon/HTTP/Source.pod  view on Meta::CPAN

=encoding utf8

=head1 NAME

Any::Daemon::HTTP::Source - source of information

=head1 INHERITANCE

 Any::Daemon::HTTP::Source is extended by
   Any::Daemon::HTTP::Directory
   Any::Daemon::HTTP::Proxy

=head1 SYNOPSIS

=head1 DESCRIPTION

Each L<Any::Daemon::HTTP::VirtualHost|Any::Daemon::HTTP::VirtualHost> will define where the files
are located.  Parts of the URI path can map on different (virtual)
resources, with different access rights.

=over 4

=item *

Directories containing files are handled by L<Any::Daemon::HTTP::Directory|Any::Daemon::HTTP::Directory>
objects.

=item *

User directories, like used in the URI C<<http://xx/~user/yy>> are
implemented in L<Any::Daemon::HTTP::UserDirs|Any::Daemon::HTTP::UserDirs>, which extends this class.

=item *

Forwarding proxies translate a path into requests to a remote server.
The reply is returned.  Various rules can be applied.  Implemented in
L<Any::Daemon::HTTP::Proxy|Any::Daemon::HTTP::Proxy>.

=back

=head1 METHODS

=head2 Constructors

=over 4

=item Any::Daemon::HTTP::Source-E<gt>B<new>(%options|\%options)

 -Option--Default
  allow   <undef>
  deny    <undef>
  name    path
  path    '/'

=over 2

=item allow => CIDR|HOSTNAME|DOMAIN|CODE|ARRAY

Allow all requests which pass any of these parameters, and none
of the deny parameters.  See L</Allow access>.  B<Be warned> that
the access rights are not inherited from directory configurations