<?php
/* $Id$ */
namespace Mammut\Cache;

(defined('MAMMUT') && (basename(__FILE__) != basename($_SERVER['PHP_SELF']))) or die('ACCESS DENIED');

/**
 * Unified cache interface
 *
 * This interface unifies the access to different PHP caching solutions.
 *
 * @author Stefan Daurer <s.daurer@q-spot.org>
 * @package Mammut\Cache
 */
interface iCache {

	/**
	 * Sets a value in the cache
	 * @param string $key the entry key
	 * @param mixed $value a value or a function providing the value
	 * @param int $ttl the cache lifetime in seconds
	 */
	public function set($key, $value, $ttl);

	/**
	 * Receives a value from the cache
	 * @param string $key the entry key
	 * @param string $default a value or a function providing a default value
	 */
	public function get($key, $default = NULL);

	public function delete($key);

	public function keyExists($key);

	public function clear();

	public function getHits();
}