Caching

Cache files can be used for whatever you like and are stored by key without file extensions, unless you give one to them. Namespaces are recommended.

Two files are created when you cache a file: file-ns.thekey and meta-ns.thekey. The meta- file stores the expiry and may hold more information in the future. The file- stores the content.

Cache directory

There is both a public and private cache dir. Both of which are in Liaison's directory by default.

  • The cache is used by the Resources class to handle your compiled css and js files.

To change the cachedir do:

$lia->set('lia.cacheDir', $yourPackage->dir('cache'));  
  • You MAY use an explicit path instead of using your $package->dir() lookup
  • lia.cacheDir may be anywhere you like.

Notes? I guess

Call $lia->cacheFile($key, $content, $maxAgeInSeconds) to store a file in the cache.

  • You may leave off $maxAgeInSeconds to use the default, which is five days
  • Cache files cannot be loaded after they expire and will be automatically cleaned up at some point.

Call $lia->getCacheFile($key) to get the contents of a cached file

  • returns false if the cache file does not exist or has expired
  • Files are returned as a string. JSON is not decoded. PHP files are not processed.