Skip to content
tpl_cache.inc.php 5.36 KiB
Newer Older
latham's avatar
latham committed
<?php
/* vim: set expandtab tabstop=4 shiftwidth=4: */
// +----------------------------------------------------------------------+
// | PHP version 4.0                                                      |
// +----------------------------------------------------------------------+
// | Copyright (c) 2002 Active Fish Group                                 |
// +----------------------------------------------------------------------+
// | Authors: Kelvin Jones <kelvin@kelvinjones.co.uk>                     |
// +----------------------------------------------------------------------+
//
// $Id: cache.php,v 1.1 2003/07/08 12:32:06 platinum Exp $

/**
 * Class uses all of vlibTemplate's functionality but caches the template files.
 * It creates an identical tree structure to your filesystem but with cached files.
 *
 * @author Kelvin Jones <kelvin@kelvinjones.co.uk>
 * @since 22/02/2002
 * @package vLIB
 * @access public
 */

latham's avatar
latham committed
class tplc extends tpl {

	/*-----------------------------------------------------------------------------\
latham's avatar
latham committed
|     DO NOT TOUCH ANYTHING IN THIS CLASS, IT MAY NOT WORK OTHERWISE           |
\-----------------------------------------------------------------------------*/

	var $_cache = 1;     // tells vlibTemplate that we're caching
	var $_cachefile;     // full path to current cache file (even if it doesn't yet exist)
	var $_cacheexists;   // has this file been cached before
	var $_cachefilelocked; // is this file currently locked whilst writing
	var $_cachefiledir;  // dir of current cache file
	var $_clearcache = 0;


	/**
	 * FUNCTION: clearCache
	 * will unset a file, and set $this->_cacheexists to 0.
	 *
	 * @access public
	 * @return boolean
	 */
	function clearCache() {
		$this->_clearcache = 1;
		return true;
	}


	/**
	 * FUNCTION: recache
	 * alias for clearCache().
	 *
	 * @access public
	 * @return boolean
	 */
	function recache() {
		return $this->clearCache();
	}


	/**
	 * FUNCTION: setCacheLifeTime
	 * sets the lifetime of the cached file
	 *
	 * @param int $int number of seconds to set lifetime to
	 * @access public
	 * @return boolean
	 */
	function setCacheLifeTime($int = null) {
		if ($int == null || !is_int($int)) return false;
		if ($int == 0) $int = 60;
		if ($int == -1) $int = 157680000; // set to 5 yrs time
		$this->OPTIONS['CACHE_LIFETIME'] = $int;
		return true;
	}


	/**
	 * FUNCTION: setCacheExtension
	 * sets the extention of the cache file
	 *
	 * @param str $str name of new cache extention
	 * @access public
	 * @return boolean
	 */
	function setCacheExtension($str = null) {
		if ($str == null || !preg_match('/^[a-z0-9]+$/', strtolower($str))) return false;
		$this->OPTIONS['CACHE_EXTENSION'] = strtolower($str);
		return true;
	}


	/*----------------------------------------\
latham's avatar
latham committed
          Private Functions
-----------------------------------------*/


	/**
	 * FUNCTION: _checkCache
	 * checks if there's a cache, if there is then it will read the cache file as the template.
	 */
	function _checkCache ($tmplfile, $tmpl_from_string = false) {
		$this->_cachefile = $this->_getFilename($tmplfile, $tmpl_from_string);
		if ($this->_clearcache) {
			if (file_exists($this->_cachefile)) unlink($this->_cachefile);
			return false;
		}

		if (file_exists($this->_cachefile)) {
			$this->_cacheexists = 1;

			// if it's expired
			if ((filemtime($this->_cachefile) + $this->OPTIONS['CACHE_LIFETIME']) < date('U')
				|| filectime($this->_cachefile) < filemtime($tmplfile)) {
				$this->_cacheexists = 0;
				return false; // so that we know to recache
			}
			else {
				return true;
			}

		} else {
			$this->_cacheexists = 0;
			return false;
		}
	}


	/**
	 * FUNCTION: _getFilename
	 * gets the full pathname for the cached file
	 *
	 */
	function _getFilename($tmplfile, $tmpl_from_string = false) {
		if($tmpl_from_string == true) return $this->OPTIONS['CACHE_DIRECTORY'].'/'.md5('vlibCachestaRSTRING'.$tmplfile).'.'.$this->OPTIONS['CACHE_EXTENSION'];
		else return $this->OPTIONS['CACHE_DIRECTORY'].'/'.md5('vlibCachestaR'.realpath($tmplfile)).'.'.$this->OPTIONS['CACHE_EXTENSION'];
	}


	/**
	 * FUNCTION: _createCache
	 * creates the cached file
	 *
	 */
	function _createCache($data) {
		$cache_file = $this->_cachefile;
		if(!$this->_prepareDirs($cache_file)) return false; // prepare all of the directories

		$f = fopen($cache_file, "w");
		flock($f, 2); // set an EXclusive lock
		if (!$f) vlibTemplateError::raiseError('VT_ERROR_NO_CACHE_WRITE', KILL, $cache_file);
		fputs($f, $data); // write the parsed string from vlibTemplate
		flock($f, 3); // UNlock file
		fclose($f);
		touch($cache_file);
		return true;
	}


	/**
	 * FUNCTION: _prepareDirs
	 * prepares the directory structure
	 *
	 */
	function _prepareDirs($file) {
		if (empty($file)) die('no filename'); //do error in future
		$filepath = dirname($file);
		if (is_dir($filepath)) return true;

		$dirs = preg_split('/[\\/]/', $filepath);
		$currpath;
		foreach ($dirs as $dir) {
			$currpath .= $dir .'/';
			$type = @filetype($currpath);

			($type=='link') and $type = 'dir';
			if ($type != 'dir' && $type != false && !empty($type)) {
				vlibTemplateError::raiseError('VT_ERROR_WRONG_CACHE_TYPE', KILL, 'directory: '.$currpath.', type: '.$type);
			}
			if ($type == 'dir') {
				continue;
			}
			else {
				$s = @mkdir($currpath, 0775);
				if (!$s) vlibTemplateError::raiseError('VT_ERROR_CACHE_MKDIR_FAILURE', KILL, 'directory: '.$currpath);
			}
		}
		return true;
	}
latham's avatar
latham committed

} // -- end vlibTemplateCache class