info > Cache::FileCache

man perldoc info pydoc3 ri search

Cache::FileCache(3pm) User Contributed Perl DocumentationCache::FileCache(3pm)

📛 NAME

Cache::FileCache — implements the Cache interface.

🚀 Quick Reference

Use Case	Command	Description
Create a new file cache	my $cache = new Cache::FileCache( { 'namespace' => 'MyNamespace', 'default_expires_in' => 600 } );	Instantiate a shared filesystem cache with namespace and expiry
Set cache root	$cache->set_cache_root('/path/to/cache')	Override the filesystem root directory for the cache
Set cache depth	$cache->set_cache_depth(4)	Control subdirectory depth to spread objects across directories
Set directory umask	$cache->set_directory_umask('077')	Restrict permissions on cache directories (default: world-writable)

📖 DESCRIPTION

The FileCache class implements the Cache interface. This cache stores data in the filesystem so that it can be shared between processes.

🔧 SYNOPSIS

  use Cache::FileCache;

  my $cache = new Cache::FileCache( { 'namespace' => 'MyNamespace',
                                      'default_expires_in' => 600 } );

See Cache::Cache for the usage synopsis.

⚙️ METHODS

See Cache::Cache for the API documentation.

• Clear( [$cache_root] ) — See Cache::Cache, with the optional $cache_root parameter.
• Purge( [$cache_root] ) — See Cache::Cache, with the optional $cache_root parameter.
• Size( [$cache_root] ) — See Cache::Cache, with the optional $cache_root parameter.

🔧 OPTIONS

See Cache::Cache for standard options. Additionally, options are set by passing in a reference to a hash containing any of the following keys:

• cache_root — The location in the filesystem that will hold the root of the cache. Defaults to the FileCache under the OS default temp directory (often /tmp on UNIXes) unless explicitly set.
• cache_depth — The number of subdirectories deep to cache object item. This should be large enough that no cache directory has more than a few hundred objects. Defaults to 3 unless explicitly set.
• directory_umask — The directories in the cache on the filesystem should be globally writable to allow for multiple users. While this is a potential security concern, the actual cache entries are written with the user's umask, thus reducing the risk of cache poisoning. If you desire it to only be user writable, set the directory_umask option to 077 or similar. Defaults to 000 unless explicitly set.

📋 PROPERTIES

See Cache::Cache for default properties.

• (get|set)_cache_root — See the definition above for the option cache_root.
• (get|set)_cache_depth — See the definition above for the option cache_depth.
• (get|set)_directory_umask — See the definition above for the option directory_umask.

📚 SEE ALSO

Cache::Cache

✍️ AUTHOR

Original author: DeWitt Clinton <dewitt AT unto.net>

Last author: $Author: dclinton $

Copyright (C) 2001-2003 DeWitt Clinton

perl v5.20.2 2015-01-22 Cache::FileCache(3pm)

📛 NAME 🚀 Quick Reference 📖 DESCRIPTION 🔧 SYNOPSIS ⚙️ METHODS 🔧 OPTIONS 📋 PROPERTIES 📚 SEE ALSO ✍️ AUTHOR