Source for file Apc.php

Documentation is available at Apc.php

  1. <?php
  2. /*
  3.  *  $Id: Apc.php 1080 2007-02-10 18:17:08Z romanb $
  4.  *
  5.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  6.  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  7.  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  8.  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  9.  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  10.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  11.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  12.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  13.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  14.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  15.  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  16.  *
  17.  * This software consists of voluntary contributions made by many individuals
  18.  * and is licensed under the LGPL. For more information, see
  19.  * <http://www.phpdoctrine.com>.
  20.  */
  21.  
  22. /**
  23.  * Doctrine_Cache_Apc
  24.  *
  25.  * @package     Doctrine
  26.  * @subpackage  Doctrine_Cache
  27.  * @license     http://www.opensource.org/licenses/lgpl-license.php LGPL
  28.  * @category    Object Relational Mapping
  29.  * @link        www.phpdoctrine.com
  30.  * @since       1.0
  31.  * @version     $Revision: 1080 $
  32.  * @author      Konsta Vesterinen <kvesteri@cc.hut.fi>
  33.  */
  34. {
  35.     /**
  36.      * constructor
  37.      * 
  38.      * @param array $options    associative array of cache driver options
  39.      */
  40.     public function __construct($options array())
  41.     {      
  42.         if extension_loaded('apc')) {
  43.             throw new Doctrine_Cache_Exception('The apc extension must be loaded for using this backend !');
  44.         }
  45.         parent::__construct($options);
  46.     }
  47.     /**
  48.      * Test if a cache is available for the given id and (if yes) return it (false else)
  49.      * 
  50.      * Note : return value is always "string" (unserialization is done by the core not by the backend)
  51.      * 
  52.      * @param string $id cache id
  53.      * @param boolean $testCacheValidity        if set to false, the cache validity won't be tested
  54.      * @return string cached datas (or false)
  55.      */
  56.     public function fetch($id$testCacheValidity true
  57.     {
  58.         $tmp apc_fetch($id);
  59.         if (is_array($tmp)) {
  60.             return $tmp[0];
  61.         }
  62.         return false;
  63.     }
  64.     /**
  65.      * Test if a cache is available or not (for the given id)
  66.      *
  67.      * @param string $id cache id
  68.      * @return mixed false (a cache is not available) or "last modified" timestamp (int) of the available cache record
  69.      */
  70.     public function contains($id
  71.     {
  72.         $tmp apc_fetch($id);
  73.         if (is_array($tmp)) {
  74.             return $tmp[1];
  75.         }
  76.         return false;
  77.     }
  78.     /**
  79.      * Save some string datas into a cache record
  80.      *
  81.      * Note : $data is always saved as a string
  82.      *
  83.      * @param string $data      data to cache
  84.      * @param string $id        cache id
  85.      * @param int $lifeTime     if != false, set a specific lifetime for this cache record (null => infinite lifeTime)
  86.      * @return boolean true if no problem
  87.      */
  88.     public function save($id$data$lifeTime false)
  89.     {
  90.         $lifeTime $this->getLifeTime($lifeTime);
  91.  
  92.         return (bool) apc_store($idarray($datatime())$lifeTime);
  93.     }
  94.     /**
  95.      * Remove a cache record
  96.      * 
  97.      * @param string $id cache id
  98.      * @return boolean true if no problem
  99.      */
  100.     public function delete($id
  101.     {
  102.         return apc_delete($id);
  103.     }
  104. }