The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Any::Daemon::HTTP::UserDirs - describe user directories

INHERITANCE

Any::Daemon::HTTP::UserDirs
  is an Any::Daemon::HTTP::Directory
  is an Any::Daemon::HTTP::Source

SYNOPSIS

# implicit creation of ::Directory object
my $vh = Any::Daemon::HTTP::VirtualHost
  ->new(user_dirs => {location => ...})

# explicit use
my $ud = Any::Daemon::HTTP::Directory::UserDirs
  ->new(location => sub {...});
my $vh = Any::Daemon::HTTP::VirtualHost->new(user_dirs => $ud);

DESCRIPTION

Each Any::Daemon::HTTP::VirtualHost may define user directories.

Extends "DESCRIPTION" in Any::Daemon::HTTP::Directory.

METHODS

Extends "METHODS" in Any::Daemon::HTTP::Directory.

Constructors

Extends "Constructors" in Any::Daemon::HTTP::Directory.

Any::Daemon::HTTP::UserDirs->new(%options|\%options)

The user-dir rewrite routine has by default Apache-like behavior.

-Option        --Defined in                  --Default
 allow           Any::Daemon::HTTP::Source     <undef>
 allow_users                                   undef
 charset         Any::Daemon::HTTP::Directory  utf-8
 deny            Any::Daemon::HTTP::Source     <undef>
 deny_users                                    []
 directory_list  Any::Daemon::HTTP::Directory  <false>
 index_file      Any::Daemon::HTTP::Directory  ['index.html', 'index.htm']
 location        Any::Daemon::HTTP::Directory  CODE
 name            Any::Daemon::HTTP::Source     path
 path            Any::Daemon::HTTP::Source     <ignored>
 user_subdirs                                  'public_html'
allow => CIDR|HOSTNAME|DOMAIN|CODE|ARRAY
allow_users => ARRAY

Lists the user homes which are available. Cannot be used together with deny_users. By default, all user homes are permitted, even those of system usernames like ftp and cups. Only used with the default user-dir rewrite rule.

charset => STRING
deny => CIDR|HOSTNAME|DOMAIN|CODE|ARRAY
deny_users => ARRAY

Only used with the default user-dir rewrite rule.

directory_list => BOOLEAN
index_file => STRING|ARRAY
location => DIRECTORY|CODE
name => STRING
path => PATH
user_subdirs => PATH

Only used with the default user-dir rewrite rule.

Attributes

Extends "Attributes" in Any::Daemon::HTTP::Directory.

$obj->charset()

Inherited, see "Attributes" in Any::Daemon::HTTP::Directory

$obj->location()

Inherited, see "Attributes" in Any::Daemon::HTTP::Directory

$obj->name()

Inherited, see "Attributes" in Any::Daemon::HTTP::Source

$obj->path()

Inherited, see "Attributes" in Any::Daemon::HTTP::Source

Permissions

Extends "Permissions" in Any::Daemon::HTTP::Directory.

$obj->allow($session, $request, $uri)

Inherited, see "Permissions" in Any::Daemon::HTTP::Source

$obj->collect($vhost, $session, $request, $uri)

Inherited, see "Permissions" in Any::Daemon::HTTP::Source

Actions

Extends "Actions" in Any::Daemon::HTTP::Directory.

$obj->filename($path)

Inherited, see "Actions" in Any::Daemon::HTTP::Directory

$obj->list($directory, %options)

Inherited, see "Actions" in Any::Daemon::HTTP::Directory

DETAILS

Extends "DETAILS" in Any::Daemon::HTTP::Directory.

SEE ALSO

This module is part of Any-Daemon-HTTP distribution version 0.28, built on March 20, 2019. Website: http://perl.overmeer.net/any-daemon/

LICENSE

Copyrights 2013-2019 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://dev.perl.org/licenses/