SimpleWebPresenter: CacheTimeCheck.inc annotate

annotate CacheTimeCheck.inc @ 60:63ea1cfd387d

Branch merge

author	Tom Fredrik "BFG" Klaussen <bfg@blenning.no>
date	Thu, 11 Oct 2012 17:05:25 +0200
parents	3898353ed1d8
children	164268b4e0d9

rev	line source
0 d2da64705bce Refactored everything in the CMS into this repos. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: diff changeset	1 <?php
52 3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	2 $baseDir = dirname(__FILE__);
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	3
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	4 include_once 'logger.inc';
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	5 include_once 'common-functions.inc';
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	6 $cache = CacheTimeCheck::instance(__FILE__);
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	7 $cache->cache_time("${baseDir}/logger.inc");
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	8 $cache->cache_time("${baseDir}/common-functions.inc");
3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	9
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	10 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	11 * CacheTimeCheck provides a set of functions to enable generating a
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	12 * correct time for the latest update for a given file.
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	13 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	14 * @author Tom Fredrik Blenning Klaussen
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	15 */
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	16 class CacheTimeCheck
14 91ee5f49907e Correct caching. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 6 diff changeset	17 {
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	18 private $newest;
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	19 private $files = array();
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	20 private static $myInstance = 0;
6 6c0162497d56 Improved error reporting, and support for multilevel params. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 0 diff changeset	21
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	22 private function __construct($filename = False)
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	23 {
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	24 if ($filename)
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	25 $this->cache_time($filename);
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	26 $this->cache_time(__FILE__);
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	27 }
0 d2da64705bce Refactored everything in the CMS into this repos. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: diff changeset	28
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	29 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	30 * List a set of files which contributes to this pages cacheset.
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	31 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	32 * @param $humanReadable If the timestamp should be humand readable.
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	33 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	34 * @return an associative array of file, and timestamp
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	35 */
47 66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	36 function cacheSet($humanReadable = False)
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	37 {
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	38 $retVal = array();
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	39 foreach($this->files as $file) {
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	40 $mtime = filemtime($file);
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	41 if ($humanReadable)
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	42 $mtime = gmdate('D, d M Y H:i:s', $mtime) . ' GMT';
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	43
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	44 $retVal[$file] = $mtime;
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	45 }
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	46 return $retVal;
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	47 }
66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	48
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	49 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	50 * Generates a singleton instance of this CacheTimeCheck
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	51 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	52 * @param $filename an optional file to include in the cacheset
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	53 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	54 * @return a CacheTimeCheck object
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	55 */
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	56 function instance($filename = False)
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	57 {
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	58 if (! self::$myInstance)
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	59 self::$myInstance = new self($filename);
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	60 elseif ($filename)
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	61 self::$myInstance->cache_time($filename);
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	62 return self::$myInstance;
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	63 }
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	64
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	65 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	66 * Checks if a HTTP_IF_MODIFIED_SINCE header is set, if this file is
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	67 * newer, set a Last-Modified header, otherwise abort with an 304
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	68 * status code
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	69 */
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	70 function CheckHttpModified()
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	71 {
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	72 if (DEBUG_LEVEL >= VERBOSITY_DEBUG)
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	73 var_dump($_SERVER);
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	74
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	75 $gmdate_mod = gmdate('D, d M Y H:i:s', $this->newest) . ' GMT';
40 fbbb82ced6de Fixes for CacheTimeCheck->includeOnce paths. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 39 diff changeset	76
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	77 if(array_key_exists('HTTP_IF_MODIFIED_SINCE', $_SERVER)) {
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	78 $HTTP_IF_MODIFIED_SINCE = $_SERVER['HTTP_IF_MODIFIED_SINCE'];
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	79 $if_modified_since = preg_replace('/;.*$/', '', $HTTP_IF_MODIFIED_SINCE);
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	80
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	81 if (strtotime($if_modified_since) >= $this->newest) {
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	82 header("HTTP/1.0 304 Not Modified");
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	83 exit;
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	84 }
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	85 }
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	86
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	87 header("Last-Modified: $gmdate_mod");
14 91ee5f49907e Correct caching. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 6 diff changeset	88 }
16 a64e8f968e7e Fast abort if cachehit. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 15 diff changeset	89
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	90 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	91 * Include a file in the cacheset
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	92 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	93 * @param $path the path of the file
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	94 */
50 2d0cda52f43f Remove unused variable. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 48 diff changeset	95 function cache_time($path)
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	96 {
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	97 if (!file_exists($path)) {
47 66382989353f Extract baseDir only once. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 40 diff changeset	98 warn("${path} does not exist");
52 3898353ed1d8 Include fixes. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 50 diff changeset	99 errorPage("Resource is not available");
39 bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	100 }
bd82b719a0de Make CacheTimeCheck a singleton. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 38 diff changeset	101
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	102 array_push($this->files, $path);
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	103 $mtime = filemtime($path);
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	104 if ($mtime > $this->newest) {
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	105 $this->newest = $mtime;
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	106 }
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	107 }
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	108
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	109 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	110 * Convenience function to include a file, and add it to the cacheset.
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	111 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	112 * @param $path path of the file
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	113 * @param $basedir a directory to prepend to the path
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	114 */
40 fbbb82ced6de Fixes for CacheTimeCheck->includeOnce paths. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 39 diff changeset	115 function includeOnce($path, $basedir = false)
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	116 {
40 fbbb82ced6de Fixes for CacheTimeCheck->includeOnce paths. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 39 diff changeset	117 if ($basedir)
fbbb82ced6de Fixes for CacheTimeCheck->includeOnce paths. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 39 diff changeset	118 $path = $basedir . "/" . $path;
32 7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	119 $this->cache_time($path);
7b19be62ea94 Remove yet another global, replace by CacheTimeCheck class. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 27 diff changeset	120 include_once($path);
16 a64e8f968e7e Fast abort if cachehit. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 15 diff changeset	121 }
38 42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	122
48 c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	123 /**
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	124 * Convenience function to load a file, and add it to the cacheset
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	125 *
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	126 * @param $path path of the file
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	127 * @return the contents of the file
c6d0892f81ff Documentation. Tom Fredrik Blenning Klaussen <bfg@blenning.no> parents: 47 diff changeset	128 */
38 42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	129 function loadFile($path)
42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	130 {
42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	131 $this->cache_time($path);
42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	132 return loadFile($path);
42533600214b Rename cache_check.inc to CacheTimeCheck.inc. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 32 diff changeset	133 }
16 a64e8f968e7e Fast abort if cachehit. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 15 diff changeset	134 }
50 2d0cda52f43f Remove unused variable. Tom Fredrik "BFG" Klaussen <bfg@blenning.no> parents: 48 diff changeset	135 ?>

Mercurial > SimpleWebPresenter

annotate CacheTimeCheck.inc @ 60:63ea1cfd387d