=pod

=for comment
DO NOT EDIT. This Pod was generated by Swim.
See http://github.com/ingydotnet/swim-pm#readme

=encoding utf8

=head1 NAME

Plack::Middleware::Cache - Use Cached Responses of Certain URIs

=for html
<a href="https://travis-ci.org/ingydotnet/plack-middleware-cache-pm"><img src="https://travis-ci.org/ingydotnet/plack-middleware-cache-pm.png" alt="plack-middleware-cache-pm"></a>
<a href="https://coveralls.io/r/ingydotnet/plack-middleware-cache-pm?branch=master"><img src="https://coveralls.io/repos/ingydotnet/plack-middleware-cache-pm/badge.png" alt="plack-middleware-cache-pm"></a>

=head1 SYNOPSIS

    builder {
        enable "Cache",
            match_url => [
                '^/foo/',
                '\\?.*xxx=.*',
            ],
            cache_dir => '/tmp/plack-cache';
        $app;
    };

=head1 DESCRIPTION

This middleware allows you to cache expensive and non-changing responses from
URIs that match a list of regular expression patterns.

=head1 PARAMETERS

The following parameters can be used:

=over

=item match_url (required)

A regexp string or array ref of regexp strings to try to match the current
URL against.

=item cache_dir (optional)

A directory to write the cached responses.

=item debug (optional)

Set to 1 to warn cache information.

=back

=head1 THANKS

Thanks to Strategic Data for supporting the writing and release of this
module.

=head1 AUTHOR

Ingy döt Net <ingy@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright 2011-2014. Ingy döt Net.

This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

See L<http://www.perl.com/perl/misc/Artistic.html>

=cut