NAME
Apache::Wyrd::Services::FileCache - Cache service for frequently-accessed files
SYNOPSIS
use Apache::Wyrd::Services::FileCache;
$self->get_cached('/var/lib/www/document_template.html');DESCRIPTION
The FileCache is designed to reduce the number of disk accesses required for Wyrds to make use of frequently-used files. It stores such files in memory, checking every 30 seconds to see if they are changed. As the perl environment persists under mod_perl, the cache persists with it.
For areas where changes are very frequent (such as during development), the caching behavior can be turned off within the apache config by setting NoFileCache to a true value:
PerlSetVar NoFileCache 1The time between checks is also confiruable using a PerlSetVar directive:
PerlSetVar FileCacheTimeout xWhere x is a number of seconds.
FLAGS
- allow_nonexistent_files
-
Do not report a fatal error if the file can't be found. Instead, return undef for contents.
METHODS
(format: (returns) name (arguments after self))
- (scalar)
get_cached(scalar) -
Get the file contents. If the file has never been read by this process, it is read into memory. The argument should be an absolute path to the file.
BUGS/CAVEATS/RESERVED METHODS
reserves the private global variables: $_file_cache_register, $_file_timestamp_register, and $_previous_checktime_register.
AUTHOR
Barry King <wyrd@nospam.wyrdwright.com>
SEE ALSO
LICENSE
Copyright 2002-2007 Wyrdwright, Inc. and licensed under the GNU GPL.
See LICENSE under the documentation for Apache::Wyrd.