Dokuwiki - Cache Dev configuration

> DokuWiki

1 - Cache

2 - Cache Structure

Cache.php structure:


2.1 - Instruction

In cache.php, set $_nocache to true

 * Generic handling of caching
class cache {
    public $key = '';          // primary identifier for this item
    public $ext = '';          // file ext for cache data, secondary identifier for this item
    public $cache = '';        // cache file name
    public $depends = array(); // array containing cache dependency information,
                               //   used by _useCache to determine cache validity
    var $_event = '';       // event to be triggered during useCache
    var $_time;
    var $_nocache = true;  // if set to true, cache will not be used or stored

2.2 - Rendering

Disable the whole render cache by setting the cache page time to -1.

See cache→_addDependencies in cache.php, instructions if ($conf['cachetime'] == -1)

2.3 - No cache


disable only XHTML cache ?

2.4 - Purge

2.5 - Javascript

When you are developing new JavaScript, be sure to refresh your browser cache (hitting Shift-F5, Shift+CTRL+R or similar) whenever your script was updated.

DokuWiki will load JavaScript from the following places:

  • autogenerated JavaScript (language strings, config settings, toolbar)
  • lib/scripts/*.js
  • lib/plugins/*/script.js
  • lib/tpl/<currenttemplate>/script.js
  • conf/userscript.js

Plugin !!! The script file is named script.js at the root directory of the plugin. If this file is an include as in the move plugin, be sure to touch this file when one of the scripts has been updated to refresh caching. As the cache check the date of this file.

jQuery(function() {
    /* DOKUWIKI:include script/form.js */
    /* DOKUWIKI:include script/progress.js */
    /* DOKUWIKI:include script/tree.js */
    /* DOKUWIKI:include script/rename.js */
    /* DOKUWIKI:include script/admin_list.js */

2.6 - Css

Ctrl+F5 to suppress the browser cache because browsers cache stylesheets even when new versions are available.

2.7 - Image

Images caching

Local Server:


External Server with the cachetime config option


2.8 - Configuration

Turn off “Compact CSS and JavaScript files” while developing a template