TYPO3 Core

* Automatic version-numbers of CSS and JS files to avoid caching problems: This feature provides automatic numbering of CSS and JS files using the files modified timestamp. This way the file reference will change when a CSS or JS files is changed, and by this the browser and proxy will re-cache the file. Can be configured to include the timestamp within the the filename (before .ext) or as a parameter to the file (default).

If versioning is done inside the filename (by setting TYPO3_CONF_VARS[BE][versionNumberInFilename] to true) you need this line as the first rewrite rule in .htaccess:

# Rule for versioned static files (see TYPO3_CONF_VARS[BE][versionNumberInFilename])

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif)$ $1.$3 [L]

Developers can use this API for versioning of files in the own backend mods, by calling t3lib_div::createVersionNumberedFilename or using the core API for including files in the page renderer class.

'versionNumberInFilename' => FALSE, // Boolean. If true, included CSS and JS files will have the timestamp embedded in the filename, ie. filename.1269312081.js. This will make browsers and proxies reload the files if they change (thus avoiding caching issues). IMPORTANT: this feature requires this .htaccess rule to work: RewriteCond %{REQUEST_FILENAME} !-f - RewriteCond %{REQUEST_FILENAME} !-d - RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif)$ $1.$3 [L]. If false the filemtime will be appended as a query-string.

'versionNumberInFilename' => '', // String. Set this to include a timestamp based version to added CSS and JS filenames on the rendered page. Set to 'embed' will have the timestamp embedded in the filename, ie. filename.1269312081.js. This will make browsers and proxies reload the files if they change (thus avoiding caching issues). IMPORTANT: 'embed' requires this .htaccess rule to work: RewriteCond %{REQUEST_FILENAME} !-f - RewriteCond %{REQUEST_FILENAME} !-d - RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif)$ $1.$3 [L]. If 'querystring' the filemtime will be appended as a query-string. Default setting of '' will turn off this functionality.

/**

* Function for static version numbers on files, based on the filemtime

*

* This will make the filename automatically change when a file is

* changed, and by that re-cached by the browser. If the file does not

* exist physically the original file passed to the function is

* returned without the timestamp.

*

* Behaviour is influenced by the setting

* TYPO3_CONF_VARS[TYPO3_MODE][versionNumberInFilename]

* = true (BE) / "embed" (FE) : modify filename

* = false (BE) / "querystring" (FE) : add timestamp as parameter

*

* @param string $file Relative path to file including all potential query parameters (not htmlspecialchared yet)

* @param boolean $forceQueryString If settings would suggest to embed in filename, this parameter allows us to force the versioning to occur in the query string. This is needed for scriptaculous.js which cannot have a different filename in order to load its modules (?load=...)

* @return Relative path with version filename including the timestamp

* @author Lars Houmark <lars@houmark.com>

*/

public static function createVersionNumberedFilename($file, $forceQueryString = FALSE) {

$lookupFile = explode('?', $file);

$path = self::resolveBackPath(self::dirname(PATH_thisScript) .'/'. $lookupFile[0]);

if (TYPO3_MODE == 'FE') {

$mode = strtolower($GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['versionNumberInFilename']);

if ($mode === 'embed') {

$mode = TRUE;

} else if ($mode === 'querystring') {

$mode = FALSE;

} else {

$doNothing = TRUE;

}

} else {

$mode = $GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['versionNumberInFilename'];

}

if (! file_exists($path) || $doNothing) {

// File not found, return filename unaltered

$fullName = $file;

} else if (! $mode || $forceQueryString) {

// If use of .htaccess rule is not configured,

// we use the default query-string method

if ($lookupFile[1]) {

$separator = '&';

} else {

$separator = '?';

}

$fullName = $file . $separator . filemtime($path);

} else {

// Change the filename

$name = explode('.', $lookupFile[0]);

$extension = array_pop($name);

array_push($name, filemtime($path), $extension);

$fullName = implode('.', $name);

// append potential query string

$fullName .= $lookupFile[1] ? '?' . $lookupFile[1] : '';

}

return $fullName;

}

$file = t3lib_div::resolveBackPath($file);

$file = t3lib_div::createVersionNumberedFilename($file);

$tag = '<link rel="' . $properties['rel'] . '" type="text/css" href="' . htmlspecialchars($file) . '" media="' . $properties['media'] . '"' . ($properties['title'] ? ' title="' . $properties['title'] . '"' : '') . ' />';

$properties['file'] = t3lib_div::resolveBackPath($properties['file']);

$properties['file'] = t3lib_div::createVersionNumberedFilename($properties['file']);

$tag = '<script src="' . htmlspecialchars($properties['file']) . '" type="' . $properties['type'] . '"></script>';

$file = t3lib_div::resolveBackPath($file);

$file = t3lib_div::createVersionNumberedFilename($file);

$tag = '<script src="' . htmlspecialchars($file) . '" type="' . $properties['type'] . '"></script>';

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . 'contrib/prototype/prototype.js') . '" type="text/javascript"></script>' . LF;

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . 'contrib/scriptaculous/scriptaculous.js' . $moduleLoadString, TRUE) . '" type="text/javascript"></script>' . LF;

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . 'contrib/extjs/ext-core' . ($this->enableExtCoreDebug ? '-debug' : '') . '.js') . '" type="text/javascript"></script>' . LF;

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . 'contrib/extjs/adapter/' . ($this->enableExtJsDebug ? str_replace('.js', '-debug.js', $this->extJSadapter) : $this->extJSadapter)) . '" type="text/javascript"></script>' . LF;

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . 'contrib/extjs/ext-all' . ($this->enableExtJsDebug ? '-debug' : '') . '.js') . '" type="text/javascript"></script>' . LF;

$out .= '<script src="' . t3lib_div::createVersionNumberedFilename($this->backPath . $extJsLocaleFile) . '" type="text/javascript" charset="utf-8"></script>' . LF;

<script type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename('../t3lib/jsfunc.evalfield.js') . '"></script>

<script type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename('js/backend.js') . '"></script>

t3lib_div::createVersionNumberedFilename($GLOBALS['BACK_PATH'] .

'res/css/t3editor.css') .

$validateForm = ' onsubmit="return validateForm(\'' . $formname . '\',\'' . implode(',',$fieldlist) . '\',' . t3lib_div::quoteJSvalue($conf['goodMess']) . ',' . t3lib_div::quoteJSvalue($conf['badMess']) . ',' . t3lib_div::quoteJSvalue($conf['emailMess']) . ')"';

$GLOBALS['TSFE']->additionalHeaderData['JSFormValidate'] = '<script type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename($GLOBALS['TSFE']->absRefPrefix . 't3lib/jsfunc.validateform.js') . '"></script>';

} else {

$validateForm = '';

}

$GLOBALS['TSFE']->additionalHeaderData['JSincludeFormupdate'] = '<script type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename($GLOBALS['TSFE']->absRefPrefix . 't3lib/jsfunc.updateform.js') . '"></script>';

$this->doc->JScode = '<script type="text/javascript" src="'. t3lib_div::createVersionNumberedFilename($BACK_PATH.'../t3lib/jsfunc.updateform.js') . '"></script>';

$this->doc->JScode .= TAB . '<link rel="stylesheet" type="text/css" href="' . t3lib_div::createVersionNumberedFilename($fileName) . '" />' . LF;

$this->doc->JScode .= TAB . '<script language="javascript" type="text/javascript" src="' . t3lib_div::createVersionNumberedFilename($fileName) . '"></script>' . LF;