ENHANCEMENT Writing caching metadata as HTML comments in FilesystemPublisher (through StaticPublisher::$include_caching_metadata) (ischommer)

This commit is contained in:
Andrew O'Neil 2012-12-17 15:51:09 +13:00 committed by Ingo Schommer
parent f674af0c73
commit f9504ee983
3 changed files with 33 additions and 2 deletions

View File

@ -223,6 +223,14 @@ class FilesystemPublisher extends StaticPublisher {
} }
} }
if(StaticPublisher::$include_caching_metadata) {
$content = str_replace(
'</html>',
sprintf("</html>\n\n<!-- %s -->", implode(" ", $this->getMetadata($url))),
$content
);
}
$files[] = array( $files[] = array(
'Content' => $content, 'Content' => $content,
'Folder' => dirname($path).'/', 'Folder' => dirname($path).'/',

View File

@ -30,6 +30,12 @@ abstract class StaticPublisher extends DataExtension {
static public function set_static_publisher_theme($theme){ static public function set_static_publisher_theme($theme){
self::$static_publisher_theme=$theme; self::$static_publisher_theme=$theme;
} }
/**
* @var boolean Includes a timestamp at the bottom of the generated HTML of each file,
* which can be useful for debugging issues with stale caches etc.
*/
static $include_caching_metadata = false;
static public function static_publisher_theme(){ static public function static_publisher_theme(){
return self::$static_publisher_theme; return self::$static_publisher_theme;
@ -152,6 +158,23 @@ abstract class StaticPublisher extends DataExtension {
return $urls; return $urls;
} }
/**
* Provides context for this URL, written as an HTML comment to the static file cache,
* which can be useful for debugging cache problems. For example, you could track the
* event or related page which triggered this republication. The returned data
* is unstructured and not intended to be consumed programmatically.
* Consider injecting standard HTML <meta> tags instead where applicable.
*
* Note: Only used when {@link $include_caching_metadata} is enabled.
*
* @param String
* @return Array A numeric array of all metadata.
*/
function getMetadata($url) {
return array(
'Cache generated on ' . date('Y-m-d H:i:s T (O)')
);
}
} }

View File

@ -114,7 +114,7 @@ class RebuildStaticCacheTask extends Controller {
if (file_exists($cacheBaseDir.'/lock')) unlink($cacheBaseDir.'/lock'); if (file_exists($cacheBaseDir.'/lock')) unlink($cacheBaseDir.'/lock');
echo "\n\n== Done! =="; echo "\n\n== Done! ==\n";
} }
public function show() { public function show() {