A simple PHP caching class
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore initial commit Dec 23, 2013
.travic.yml initial commit Dec 23, 2013
LICENSE fix doc Feb 11, 2014
composer.json fix composer Dec 23, 2013


PHPCache v. 0.1.2

PHPCache is a simple file based object cache, caching big or complex calculated data in filesystem.

Use it for:

  • Increasing speed of web application
  • Caching result objects from complex calculations
  • Caching results from complex database queries
  • Caching function calls
  • Cache primitive data types, own objects, function results


  • Define caching time in seconds, cache directory
  • Can be used with every variable / data (except. templates)
  • Load data from cache or determine new data
  • Clear caching directory
  • Garbage collector


You can either install the script manually using the require method:

require 'PHPCache.class.php';

or use the composer:

    "require": {
        "christianklisch/phpcache": "0.1.2"

This is currently the first release of PHPCache, so in this example you'll be able to update your script with any updates made to PHPCache.


Include the script in your project either with Composer or via the manual require method and create a new instance of the class, using the appropriate parameters if needed:

$cache = new PHPCache();

Possible parameters include:

$cache = new PHPCache(
	array('debug' => true, 'cacheDir' => 'cache', 'cacheTime' => 10)
 * @param  array $settings Associative array of caching settings

Primitive data type

Then cache an primitive data type with:

$myString = $cache->cacheVal('String to cache','cachingID');

This will cache the string of the first parameter into a file named by second parameter. Use the second parameter setting key for primitive data types.

Object data type

Cache an object data type with:

$myObj = new FooBar();
$obj = $cache->cacheVal($myObj, $myObj->getId());

This will cache the object in the first parameter into a file named by second parameter. Use the second parameter setting key as filename for object cache.

Object data type with automatic ID-getter

Define for each object type the id-key/primary key remove second id-parameter:

$myObj = new FooBar();

 * Setting get-functions for primary keys of classes
 * @param  array $primkeys Associative array of class primary-key-function
    'FooBar' => 'getId'

$obj = $cache->cacheVal($myObj);

Now the objects id is automatically determined by PHPCache logic. Caching configuration is

Check for cached data

Check with the given key if data is cached. Can be used to call a new cacheVal().

 * check, if key or object in first parameter is cached. Returns true, if cached
 * @return bool

    $obj = $cache->cacheVal($myObj, $key);  
    $obj = $logic->calcVal($key);  

Cache whole function calls

Like the value-caching you can cache results of complex logical function calls. The defined function will only be called in case of absence cached function results.

 * cache function result and return it
 * @return object     

$key = 1110;

$result = $cache->cacheFun(
    function () use ($key, $logic) {
        return $logic->getComplexResult();

echo "result: ".$result; 

Please don't use function parametes. Submit your variables via the use()-keyword. It is important using one parameter named 'key' for caching. The name and count of other parameters is not important. Write the call of your complex logic inside the anonymous function. This code will be called, if your key isn't found in cache.

Delete old cached data

Delete old cached data in caching directory with:

 * delete old cached files 

Garbage Collector is not called automatically.

Clear caching directory

Delete all cached data in caching directory with:

 * delete all cached files 


Copyright and license

Copyright 2014 Christian Klisch, released under the Apache license.