Cache

About Kohana Cache

[Kohana_Cache] provides a common interface to a variety of caching engines. [Cache_Tagging] is supported where available natively to the cache system. Kohana Cache supports multiple instances of cache engines through a grouped singleton pattern.

Supported cache engines

  • APC/APCu ([Cache_Apc])
  • File ([Cache_File])
  • Memcached ([Cache_Memcache])
  • Memcached-tags ([Cache_Memcachetag])
  • SQLite ([Cache_Sqlite])
  • Wincache

Introduction to caching

Caching should be implemented with consideration. Generally, caching the result of resources is faster than reprocessing them. Choosing what, how and when to cache is vital. PHP APCu is one of the fastest caching systems available, closely followed by Memcached. SQLite and File caching are two of the slowest cache methods, however usually faster than reprocessing a complex set of instructions.

Caching engines that use memory are considerably faster than file based alternatives. But memory is limited whereas disk space is plentiful. If caching large datasets, such as large database result sets, it is best to use file caching.

[!!] Cache drivers require the relevant PHP extensions to be installed. APC, eAccelerator, Memecached and Xcache all require non-standard PHP extensions.

What the Kohana Cache module does (and does not do)

This module provides a simple abstracted interface to a wide selection of popular PHP cache engines. The caching API provides the basic caching methods implemented across all solutions, memory, network or disk based. Basic key / value storing is supported by all drivers, with additional tagging and garbage collection support where implemented or required.

Kohana Cache does not provide HTTP style caching for clients (web browsers) and/or proxies (Varnish, Squid). There are other Kohana modules that provide this functionality.

Choosing a cache provider

Getting and setting values to cache is very simple when using the Kohana Cache interface. The hardest choice is choosing which cache engine to use. When choosing a caching engine, the following criteria must be considered:

  1. Does the cache need to be distributed? This is an important consideration as it will severely limit the options available to solutions such as Memcache when a distributed solution is required.
  2. Does the cache need to be fast? In almost all cases retrieving data from a cache is faster than execution. However generally memory based caching is considerably faster than disk based caching (see table below).
  3. How much cache is required? Cache is not endless, and memory based caches are subject to a considerably more limited storage resource.
Driver Storage Speed Tags Distributed Automatic Garbage Collection Notes
APC/APCu Memory Excellent No No Yes Widely available PHP opcode caching solution, improves php execution performance
Wincache Memory Excellent No No Yes Windows variant of APC
File Disk Poor No No No Marginally faster than execution
Memcache (tag) Memory Good No (yes) Yes Yes Generally fast distributed solution, but has a speed hit due to variable network latency and serialization
Sqlite Disk Poor Yes No No Marginally faster than execution

It is possible to have hybrid cache solutions that use a combination of the engines above in different contexts. This is supported with Kohana Cache as well

Minimum requirements

  • Kohana 3.0.4
  • PHP 5.2.4 or greater

Do you want to contribute to Koseven?

We need YOUR help!

This project is open source. What does this mean? YOU can help:
  • Found a bug? Report it on Github
  • Need a feature? Add it Here
  • Want to help? Join the Forum
Go to Github