<?php

/**
 * [Kohana Cache](api/Kohana_Cache) Wincache driver. Provides an opcode based
 * driver for the Kohana Cache library.
 *
 * ### Configuration example
 *
 * Below is an example of an _wincache_ server configuration.
 *
 *     return [
 *         // Driver group
 *         'wincache' => [
 *             // Using wincache driver
 *             'driver' => 'wincache',
 *         ],
 *     ];
 *
 * In cases where only one cache group is required, if the group is named `default` there is
 * no need to pass the group name when instantiating a cache instance.
 *
 * #### General cache group configuration settings
 *
 * Below are the settings available to all types of cache driver.
 *
 * Name           | Required | Description
 * -------------- | -------- | ---------------------------------------------------------------
 * driver         | __YES__  | (_string_) The driver type to use
 *
 * ### System requirements
 *
 * *  Windows XP SP3 with IIS 5.1 and » FastCGI Extension
 * *  Windows Server 2003 with IIS 6.0 and » FastCGI Extension
 * *  Windows Vista SP1 with IIS 7.0 and FastCGI Module
 * *  Windows Server 2008 with IIS 7.0 and FastCGI Module
 * *  Windows 7 with IIS 7.5 and FastCGI Module
 * *  Windows Server 2008 R2 with IIS 7.5 and FastCGI Module
 * *  PHP 5.2.X, Non-thread-safe build
 * *  PHP 5.3 X86, Non-thread-safe VC9 build
 *
 * @package    Kohana/Cache
 * @category   Base
 * @author     Kohana Team
 * @copyright  (c) 2009-2012 Kohana Team
 * @license    https://kohana.top/license
 */
class Kohana_Cache_Wincache extends Cache
{
    /**
     * Check for existence of the wincache extension This method cannot be invoked externally. The driver must
     * be instantiated using the `Cache::instance()` method.
     *
     * @param  array  $config  configuration
     * @throws Cache_Exception
     */
    protected function __construct(array $config)
    {
        if (!extension_loaded('wincache')) {
            throw new Cache_Exception('PHP wincache extension is not available.');
        }

        parent::__construct($config);
    }

    /**
     * Retrieve a cached value entry by id.
     *
     *     // Retrieve cache entry from wincache group
     *     $data = Cache::instance('wincache')->get('foo');
     *
     *     // Retrieve cache entry from wincache group and return 'bar' if miss
     *     $data = Cache::instance('wincache')->get('foo', 'bar');
     *
     * @param   string  $id       id of cache to entry
     * @param   string  $default  default value to return if cache miss
     * @return  mixed
     * @throws  Cache_Exception
     */
    public function get($id, $default = null)
    {
        $data = wincache_ucache_get($this->_sanitize_id($id), $success);

        return $success ? $data : $default;
    }

    /**
     * Set a value to cache with id and lifetime
     *
     *     $data = 'bar';
     *
     *     // Set 'bar' to 'foo' in wincache group, using default expiry
     *     Cache::instance('wincache')->set('foo', $data);
     *
     *     // Set 'bar' to 'foo' in wincache group for 30 seconds
     *     Cache::instance('wincache')->set('foo', $data, 30);
     *
     * @param   string   $id        id of cache entry
     * @param   string   $data      data to set to cache
     * @param   integer  $lifetime  lifetime in seconds
     * @return  boolean
     */
    public function set($id, $data, $lifetime = null)
    {
        if ($lifetime === null) {
            $lifetime = Arr::get($this->_config, 'default_expire', Cache::DEFAULT_EXPIRE);
        }

        return wincache_ucache_set($this->_sanitize_id($id), $data, $lifetime);
    }

    /**
     * Delete a cache entry based on id
     *
     *     // Delete 'foo' entry from the wincache group
     *     Cache::instance('wincache')->delete('foo');
     *
     * @param   string  $id  id to remove from cache
     * @return  boolean
     */
    public function delete($id)
    {
        return wincache_ucache_delete($this->_sanitize_id($id));
    }

    /**
     * Delete all cache entries.
     *
     * Beware of using this method when
     * using shared memory cache systems, as it will wipe every
     * entry within the system for all clients.
     *
     *     // Delete all cache entries in the wincache group
     *     Cache::instance('wincache')->delete_all();
     *
     * @return  boolean
     */
    public function delete_all()
    {
        return wincache_ucache_clear();
    }

}
