The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

MBRADSHAW / Mail-Milter-Authentication-3.20230214 / lib / Mail / Milter / Authentication / HTDocs.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
—
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

              
package Mail::Milter::Authentication::HTDocs;
use 5.20.0;
use strict;
use warnings;
use Mail::Milter::Authentication::Pragmas;
# ABSTRACT: Load and serve static files via the in-built http server.
our $VERSION = '3.20230214'; # VERSION
sub new {
    my ( $class ) = @_;
    my $self = {};
    bless $self, $class;
    return $self;
}
sub get_whitelist {
    my ( $self, $path ) = @_;
    my @whitelist;
    if ( opendir( my $dh, join( '/', $self->get_basedir(), $path ) ) ) {
        while ( my $file = readdir( $dh ) ) {
            next if $file =~ /^\./;
            my $full_path = join( '/', $self->get_basedir(), $path, $file );
            if ( -f $full_path ) {
                push @whitelist, join( '/', $path, $file );
            }
            if ( -d $full_path ) {
                @whitelist = ( @whitelist, @{ $self->get_whitelist( join ( '/', $path, $file ) ) } );
            }
        }
    }
    return \@whitelist;
}
sub get_basedir {
    my ( $self ) = @_;
    my $basedir = __FILE__;
    $basedir =~ s/HTDocs\.pm$/htdocs/;
    return $basedir;
}
sub get_file {
    my ( $self, $file ) = @_;
    my $whitelisted = grep { $_ eq $file } @{ $self->get_whitelist( '' ) };
    return if ! $whitelisted;
    my $basefile = $self->get_basedir();
    $basefile .= $file;
    if ( ! -e $basefile ) {
        return;
    }
    open my $InF, '<', $basefile;
    my @Content = <$InF>;
    close $InF;
    return join( q{}, @Content );
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Mail::Milter::Authentication::HTDocs - Load and serve static files via the in-built http server.
=head1 VERSION
version 3.20230214
=head1 DESCRIPTION
Load and serve static files via the in-build http server.
=head1 CONSTRUCTOR
=head2 I<new()>
Return a new instance of this class
=head1 METHODS
=head2 I<get_whitelist()>
Return an arrayref of valid URLs/Filenames whih are allowed to be served.
=head2 I<get_basedir()>
Return the base directory for htdocs files
=head2 I<get_file( $file )>
Return a full HTTP response for the given filename, or null if it does not exist.
=head1 AUTHOR
Marc Bradshaw <marc@marcbradshaw.net>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2020 by Marc Bradshaw.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut