Constants

Docket Cache uses constants variable as main configuration methods.

Updated: 08-Mar-2023 | v22.07.04

Constants are like variables except that once they are defined they cannot be changed or undefined. To change the behaviour of Docket Cache, the following PHP constants can be defined in your wp-config.php file.

Docket Cache load the configuration by calling Constan::register_default() method that can be found in file includes/src/Constans.php. Some constant marks as @private and for internal use, changing it may result in unpredictable behaviour.

DOCKET_CACHE_MAXTTL

Default object lifespan in seconds.

Only numbers between 86400 and 2419200 are allowed. Default: 345600 (4 days)

define('DOCKET_CACHE_MAXTTL', 345600);

If there is no expire time was set to object or set to 0, Docket Cache will use this setting as an expiration time.

This setting does not apply to cache groups below if the value of seconds is lower than the predefined seconds.

Group	Key	Seconds
site-transient	update_plugins, update_themes, update_core	2419200 (28 days)
site-transient	any	604800 (7 days)
transient	any	604800 (7 days)
terms	any	1209600 (14 days)
posts	any	1209600 (14 days)
post_meta	any	1209600 (14 days)
comments	any	1209600 (14 days)
options	any	1209600 (14 days)
site-options	any	1209600 (14 days)

DOCKET_CACHE_MAXSIZE

Set the maximum size of the object data in bytes, which can be store in a cache file.

Only size between 1048576 (1MB) and 10485760 (10MB) are allowed. Default: 3145728 (3MB)

define('DOCKET_CACHE_MAXSIZE', 3145728);

Example of object data:

[
    1606534363 => [
        'wp_version_check' => [
            '40cd750bba9870f18aada2478b24840a' => [
                'schedule' => 'twicedaily',
                'args' => [],
                'interval' => 43200,
            ],
        ],
    ],
    'version' => 2,
]

The size of the cache file is slightly bigger than the object since it contains Docket Cache metadata and exported as plain PHP code.

Example of the cache file content:

[
    'timestamp' => 1606492052,
    'site_id' => 1,
    'group' => 'options',
    'key' => 'cron',
    'type' => 'string',
    'timeout' => 1607701652,
    'data' => [
        1606534363 => [
            'wp_version_check' => [
                '40cd750bba9870f18aada2478b24840a' => [
                    'schedule' => 'twicedaily',
                    'args' => [],
                    'interval' => 43200,
                ],
            ],
        ],
        'version' => 2,
    ],
]

Docket Cache Metadata:

Name	Description
timestamp	Data creation time
site_id	Site Id
network_id	Network Id (on multisite)
group	Object Cache group
key	Object Cache key
type	Object Cache Data type
timeout	Expiration time
data	Object Cache data

DOCKET_CACHE_MAXSIZE_DISK

Set the maximum size of the cache storage on disk.

The minimum required size is 104857600 bytes (100MB). Default: 524288000 (500MB)

define('DOCKET_CACHE_MAXSIZE_DISK', 524288000);

DOCKET_CACHE_MAXFILE

Set the maximum cache file can be store on disk.

Only numbers between 200 and 1000000 are allowed. Default: 50000

define('DOCKET_CACHE_MAXFILE', 50000);

DOCKET_CACHE_CHUNKCACHEDIR

Set to true to enable chunking cache files into smaller directories to avoid an excessive number of cache files in one directory.

Only enable it if you have difficulty clearing the cache manually or experience slowdowns when the cache becomes too large. Default:

define('DOCKET_CACHE_CHUNKCACHEDIR', false);

DOCKET_CACHE_MAXFILE_LIVECHECK

Set to true to allow Docket Cache to monitor the cache file limit in real-time. Default:

define('DOCKET_CACHE_MAXFILE_LIVECHECK', false);

DOCKET_CACHE_EMPTYCACHE_IGNORE

Set to true to enable excluding empty caches from being stored on disk.

Only enable it if you have an issue with inode/file limits. Default:

define('DOCKET_CACHE_EMPTYCACHE_IGNORE', false);

DOCKET_CACHE_PATH

Set the cache directory. Default:

define('DOCKET_CACHE_PATH', WP_CONTENT_DIR.'/cache/docket-cache');

DOCKET_CACHE_DATA_PATH

Set the configuration directory. Default:

define('DOCKET_CACHE_DATA_PATH', WP_CONTENT_DIR.'/docket-cache-data');

DOCKET_CACHE_CONTENT_PATH

Set the Docket Cache writable directory. Default:

define('DOCKET_CACHE_CONTENT_PATH', WP_CONTENT_DIR);

By default, Docket Cache requires writable permission on WordPress wp-content directory for internal use. Defining this constant also change the default path for cache, configuration and object-cache Drop-In. The content path must exist and has proper permission. The object-cache.php Drop-In file needs to symlink with WordPress wp-content/object-cache.php or replace with wrapper file.

Please refer to the PHP open_basedir setting before set this constant.

Example:

$ sudo mkdir -p /opt/dc-content
$ sudo chown apache:apache /opt/dc-content
$ sumod chmod 755 /opt/dc-content
$ sudo ln -s /opt/dc-content/object-cache.php /your-wp-path/wp-content/object-cache.php

Wrapper file:

<?php
if (!\defined('ABSPATH')) {
    return;
}

if (!\defined('DOCKET_CACHE_CONTENT_PATH')) {
    return;
}

if ( !@is_file(DOCKET_CACHE_CONTENT_PATH.'/object-cache.php') ) {
    return;
}

@include_once DOCKET_CACHE_CONTENT_PATH.'/object-cache.php';

DOCKET_CACHE_FLUSH_DELETE

By default Docket Cache only empty the cache file when expire. Set to true to delete the cache file instead of truncate. Default:

define('DOCKET_CACHE_FLUSH_DELETE', false);

DOCKET_CACHE_FLUSH_STALECACHE

Set to true to allow Garbage Collector (GC) immediately remove the stale cache abandoned by WordPress, WooCommerce and others after doing cache invalidation. Default:

define('DOCKET_CACHE_FLUSH_STALECACHE', false);

DOCKET_CACHE_STALECACHE_IGNORE

Set to true to enable excluding stale cache created by WordPress, WooCommerce, and others from being stored on disk. Default:

define('DOCKET_CACHE_STALECACHE_IGNORE', false);

Only enable it if you have an issue with inode/file limits.

DOCKET_CACHE_GLOBAL_GROUPS

Set the lists of groups cached at the network level in a Multisite setup. Default:

define('DOCKET_CACHE_GLOBAL_GROUPS',
  [
    'blog-details',
    'blog-id-cache',
    'blog-lookup',
    'global-posts',
    'networks',
    'rss',
    'sites',
    'site-details',
    'site-lookup',
    'site-options',
    'site-transient',
    'users',
    'useremail',
    'userlogins',
    'usermeta',
    'user_meta',
    'userslugs'
  ]
);

DOCKET_CACHE_IGNORED_GROUPS

List of cache groups that should not be cached. Default:

define('DOCKET_CACHE_IGNORED_GROUPS',
  [
    'counts',
    'plugins',
    'themes'
  ]
);

DOCKET_CACHE_IGNORED_KEYS

List of cache keys that should not be cached. Default: not set.

Example:

define('DOCKET_CACHE_IGNORED_KEYS',['key1', 'key2']);

DOCKET_CACHE_IGNORED_GROUPKEY

List of cache groups and keys that should not be cached. Default: not set.

define('DOCKET_CACHE_IGNORED_GROUPKEY',
  [
    'group1' => ['key1', 'key2'],
    'group2' => ['key1', 'key2']
  ]
);

DOCKET_CACHE_LOG

Set to true or false to enable or disable cache log. Default:

define('DOCKET_CACHE_LOG', false);

The cache log intended to provide information on how the cache works. For performance and security concerns, deactivate if no longer needed.

DOCKET_CACHE_LOG_FILE

Set the log file. Default:

define('DOCKET_CACHE_LOG_FILE', WP_CONTENT_DIR.'/.object-cache.log');

DOCKET_CACHE_LOG_TIME

Set the log time format when viewing. Available options utc, local, wp. Default:

define('DOCKET_CACHE_LOG_TIME', 'utc');

DOCKET_CACHE_LOG_FLUSH

Set to true to empty the log file when the object cache is flushed. Default:

define('DOCKET_CACHE_LOG_FLUSH', true);

DOCKET_CACHE_LOG_SIZE

Set the maximum size of the log file in bytes. Default: 10485760 (10MB)

define('DOCKET_CACHE_LOG_SIZE', 10485760);

DOCKET_CACHE_LOG_ALL

By default, Docket Cache excludes it own process if WP_DEBUG not defined as true.

Set to true or false to enable or disable to log all caches. Default:

define('DOCKET_CACHE_LOG_ALL', false);

DOCKET_CACHE_ADVCPOST

Set to true to enable Advanced Post Cache features that cache WP Queries for a post which results in faster data retrieval and reduced database workload. Default:

define('DOCKET_CACHE_ADVCPOST', true);

Since version 22.07.04, the Advanced Post Cache feature is only available for WordPress version 6.1 and below. Since it is already implemented in WordPress Core as WP_Query caching.

DOCKET_CACHE_ADVCPOSTTYPE

List of Post Types allowed for Advanced Post Cache. Default:

define('DOCKET_CACHE_ADVCPOSTTYPE',
    [
        'post',
        'page',
        'attachment',
        'revision',
        'nav_menu_item',
        'custom_css',
        'customize_changeset',
        'oembed_cache',
        'user_request',
        'wp_block',
        'wp_template',
        'wp_template_part',
        'wp_global_styles',
        'wp_navigation',
    ]
);

Since version 22.07.04, this constant only works for WordPress version 6.1 and below.

DOCKET_CACHE_ADVCPOSTTYPE_ALL

Set to true to allow all Post Types for Advanced Post Cache. Default:

define('DOCKET_CACHE_ADVCPOSTTYPE_ALL', false);

Since version 22.07.04, this constant only works for WordPress version 6.1 and below.

DOCKET_CACHE_CRONOPTMZDB

Enable Database Tables optimization.

Available options: never, daily, weekly, monthly. Default:

define('DOCKET_CACHE_CRONOPTMZDB', 'never');

DOCKET_CACHE_WPOPTALOAD

Set to true or false to enable or disable Suspend WP Options Autoload features. Default:

define('DOCKET_CACHE_WPOPTALOAD', false);

DOCKET_CACHE_MISC_TWEAKS

Set to true or false to enable or disable miscellaneous WordPress performance tweaks. Default:

define('DOCKET_CACHE_MISC_TWEAKS', true);

DOCKET_CACHE_WOOTWEAKS

Set to true or false to enable or disable miscellaneous WooCommerce tweaks. Default:

define('DOCKET_CACHE_WOOTWEAKS', true);

DOCKET_CACHE_WOOADMINOFF

WooCommerce Admin or Analytics page is a new JavaScript-driven interface for managing stores.

Set to true to disable WooCommerce Admin feature-related. Default:

define('DOCKET_CACHE_WOOADMINOFF', false);

DOCKET_CACHE_WOOWIDGETOFF

Set to true to disable WooCommerce Classic Widget feature. Default:

define('DOCKET_CACHE_WOOWIDGETOFF', false);

DOCKET_CACHE_WOOWPDASHBOARDOFF

Set to true to disable WooCommerce meta box in the WordPress Dashboard. Default:

define('DOCKET_CACHE_WOOWPDASHBOARDOFF', false);

DOCKET_CACHE_WOOCARTFRAGSOFF

Set to true to disable WooCommerce Cart Fragments feature. Default:

define('DOCKET_CACHE_WOOCARTFRAGSOFF', false);

DOCKET_CACHE_WOOADDTOCHARTCRAWLING

Set to true to enable prevent robots crawling add-to-cart links. Default:

define('DOCKET_CACHE_WOOADDTOCHARTCRAWLING', true);

DOCKET_CACHE_WOOEXTENSIONPAGEOFF

Set to true to disable WooCommerce Extensions Page feature. Default:

define('DOCKET_CACHE_WOOEXTENSIONPAGEOFF', true);

DOCKET_CACHE_POSTMISSEDSCHEDULE

Set to true or false to enable or disable Post Missed Schedule Tweaks features. Default:

define('DOCKET_CACHE_POSTMISSEDSCHEDULE', false);

DOCKET_CACHE_OPTERMCOUNT

Set to true or false to enable or disable Term Count Queries optimization features. Default:

define('DOCKET_CACHE_OPTERMCOUNT', true);

DOCKET_CACHE_OPTWPQUERY

Set to true to enable WordPress Core Query optimization features. Docket Cache will attempt to optimize WordPress core query when enabled. Default:

define('DOCKET_CACHE_OPTWPQUERY', true);

DOCKET_CACHE_LIMITBULKEDIT

Set to true or false to enable or disable the Bulk Edit Actions when reaching the listed item limit. Default:

define('DOCKET_CACHE_LIMITBULKEDIT', false);

DOCKET_CACHE_LIMITBULKEDIT_LIMIT

Set a limit of items listed for Bulk Edit Actions. Default:

define('DOCKET_CACHE_LIMITBULKEDIT_LIMIT', 100);

DOCKET_CACHE_MOCACHE

Set to true to enable WordPress Translation Caching features that improve the performance of the Translation function. Default:

define('DOCKET_CACHE_MOCACHE', false);

DOCKET_CACHE_MENUCACHE

Set to true to enable WordPress Menu Caching features that improve the performance of the WordPress menus generation. Default:

define('DOCKET_CACHE_MENUCACHE', false);

DOCKET_CACHE_MENUCACHE_TTL

Default Menu Cache lifespan in seconds.

Only numbers between 86400 and 2419200 are allowed. Default: 1209600 (14 days)

define('DOCKET_CACHE_MENUCACHE_TTL', 1209600);

DOCKET_CACHE_SIGNATURE

Set to true or false to enable or disable Docket Cache signature at HTML footer and Server Header. Default:

define('DOCKET_CACHE_SIGNATURE', true);

DOCKET_CACHE_PRECACHE

Set to true to enable Object Cache Precaching features that increase cache performance by early loading cached objects based on the current URL. Default:

define('DOCKET_CACHE_PRECACHE', true);

DOCKET_CACHE_PRECACHE_MAXFILE

Set the maximum precache file can be store on disk.

Only numbers between 100 and 1000000 are allowed. Default: 100

define('DOCKET_CACHE_PRECACHE_MAXFILE', 100);

DOCKET_CACHE_PRECACHE_MAXKEY

Set the maximum precache keys. Default: 20

define('DOCKET_CACHE_PRECACHE_MAXKEYe', 20);

DOCKET_CACHE_PRECACHE_MAXGROUP

Set the maximum precache groups. Default: 20

define('DOCKET_CACHE_PRECACHE_MAXGROUP', 20);

DOCKET_CACHE_IGNORED_PRECACHE

List of cache groups and keys that should not be precached. Default:

define('DOCKET_CACHE_IGNORED_PRECACHE',
    [
     	'freemius' => 'fs_accounts',
        'options' => [
            'uninstall_plugins',
            'auto_update_plugins',
            'active_plugins',
            'cron',
            'litespeed_messages',
            'litespeed.admin_display.messages',
        ],
	'site-options' => [
            '1:auto_update_plugins',
            '1:active_sitewide_plugins',
        ],
    ]
);

DOCKET_CACHE_PRELOAD

Set to true or false to enable or disable cache preloading. If set to true, this plugin will fetch predefined URL related to the admin page.

The preload only runs when doing a cache flush. Default:

define('DOCKET_CACHE_PRELOAD', false);

DOCKET_CACHE_PAGELOADER

Set to true or false to enable or disable Admin Page Loader features. Default:

define('DOCKET_CACHE_PAGELOADER', true);

DOCKET_CACHE_TRANSIENTDB

By default WordPress stores Transients Cache in Database. When a persistent object cache is available, it switches Transients from Database to the object cache.

Some plugins use Transients not in the right way, they store too big data without expiration time. Without expiration, WordPress will place the Transient in the "alloptions" variable. It will make persistent object caching solutions like Docket Cache unable to handle it.

Set to true or false to enable or disable retaining Transients in the Database. Default:

define('DOCKET_CACHE_TRANSIENTDB', false);

DOCKET_CACHE_IGNORED_TRANSIENTDB

A list of Transient names is excluded from being stored in the Database. Default:

define('DOCKET_CACHE_IGNORED_TRANSIENTDB',
    [
        'doing_cron',
        'update_plugins',
        'update_themes',
        'update_core',
    ]
);

DOCKET_CACHE_CRONBOT

The Cronbot is an external service that pings your website every hour to keep WordPress Cron running actively. Only site Timezone, URL and version are involved when enabling this service.

Set to true or false to enable or disable Cronbot Service. Default:

define('DOCKET_CACHE_CRONBOT', false);

DOCKET_CACHE_CRONBOT_MAX

Maximum sites allowed in Multisite setup. Default:

define('DOCKET_CACHE_CRONBOT_MAX', 10);

DOCKET_CACHE_OPCVIEWER

Set to true or false to enable or disable the OPcache viewer feature. Default:

define('DOCKET_CACHE_OPCVIEWER', false);

DOCKET_CACHE_GCACTION

Set to true to enable Docket Cache Garbage Collector action button at Overview screen. Default:

define('DOCKET_CACHE_GCACTION', false);

DOCKET_CACHE_FLUSHACTION

Set to true to enable Docket Cache the additional Flush Cache action button on the Configuration screen. Default:

define('DOCKET_CACHE_FLUSHACTION', false);

DOCKET_CACHE_AUTOUPDATE

Set to true or false to force enable or disable automatic updates of the Docket Cache. Default:

define('DOCKET_CACHE_AUTOUPDATE', true);

DOCKET_CACHE_CHECKVERSION

The Check Version allows Docket Cache to check any critical future version that requires removing cache files before doing the updates, purposely to avoid error-prone.

Set to true or false to enable or disable critical version checking. Default:

define('DOCKET_CACHE_CHECKVERSION', false);

DOCKET_CACHE_FLUSH_SHUTDOWN

Set to true or false to enable or disable to flush the object cache when disabling or uninstalling Docket Cache. Default:

define('DOCKET_CACHE_FLUSH_SHUTDOWN', false);

DOCKET_CACHE_OPCSHUTDOWN

Set to true or false to enable or disable to flush OPcache when disabling or uninstalling Docket Cache.

define('DOCKET_CACHE_OPCSHUTDOWN', false);

DOCKET_CACHE_STATS

Set to true or false to enable or disable object cache data stats at Overview screen. Default:

define('DOCKET_CACHE_STATS', true);

DOCKET_CACHE_PINGBACK

Set to true to disable WordPress XML-RPC and Pingbacks related features. Default:

define('DOCKET_CACHE_PINGBACK', false);

DOCKET_CACHE_HEADERJUNK

Set to true to disable WordPress features related to HTML header such as meta generators and feed links to reduce the page size. Default:

define('DOCKET_CACHE_HEADERJUNK', false);

DOCKET_CACHE_WPEMOJI

Set to true to disable WordPress Emoji feature. Default:

define('DOCKET_CACHE_WPEMOJI', false);

DOCKET_CACHE_WPFEED

Set to true to disable WordPress Feed feature. Default:

define('DOCKET_CACHE_WPFEED', false);

DOCKET_CACHE_WPEMBED

Set to true to disable WordPress Embed feature. Default:

define('DOCKET_CACHE_WPEMBED', false);

DOCKET_CACHE_WPLAZYLOAD

Set to true to disable WordPress Lazy Load feature. Default:

define('DOCKET_CACHE_WPLAZYLOAD', false);

DOCKET_CACHE_WPSITEMAP

Set to true to disable WordPress Auto-Sitemap feature. Default:

define('DOCKET_CACHE_WPSITEMAP', false);

DOCKET_CACHE_WPAPPPASSWORD

Set to true to disable WordPress Application Passwords feature. Default:

define('DOCKET_CACHE_WPAPPPASSWORD', false);

DOCKET_CACHE_WPDASHBOARDNEWS

Set to true to disable WordPress Events & News Feed at Dashboard. Default:

define('DOCKET_CACHE_WPDASHBOARDNEWS', false);

DOCKET_CACHE_WPBROWSEHAPPY

Set to true to disable the WordPress Browse Happy HTTP API requests, which checks whether the user needs a browser update. Default:

define('DOCKET_CACHE_WPBROWSEHAPPY', false);

DOCKET_CACHE_WPSERVEHAPPY

Set to true to disable the WordPress Serve Happy HTTP API request, which checks whether the user needs to update PHP. Default:

define('DOCKET_CACHE_WPSERVEHAPPY', false);

DOCKET_CACHE_POSTVIAEMAIL

Set to true to disable the WordPress post-via-email functionality. Default:

define('DOCKET_CACHE_POSTVIAEMAIL', false);

DOCKET_CACHE_LIMITHTTPREQUEST

Set to true to limit HTTP requests in WP-Admin.

This option will block any HTTP requests made by plugins or themes that used wp_remote_post, wp_remote_get or wp_remote_request functions that are not invoked in standard WP-Admin pages like Post, Pages, Plugins, Media and others.

Default:

define('DOCKET_CACHE_LIMITHTTPREQUEST', false);

DOCKET_CACHE_LIMITHTTPREQUEST_WHITELIST

Set the list of hosts excluded from Limit HTTP requests options. Default:

define('DOCKET_CACHE_LIMITHTTPREQUEST_WHITELIST', []);

Example:

define('DOCKET_CACHE_LIMITHTTPREQUEST_WHITELIST', 
    [
        'feeds.feedburner.com',
        'api.docketcache.com'
    ]
);

DOCKET_CACHE_GCRON_DISABLED

Set to true to disable Garbage Collector Cron Events. By defining it as true, Docket Cache will not install Cron Event for Garbage Collector. You need to run it manually using wp-cli or a custom Cron Events. Default:

define('DOCKET_CACHE_GCRON_DISABLED', false);

Example for WP-CLI:

wp cache run:gc

Example for custom Cron Events:

<?php
// Place this code in wp-content/mu-plugins/docketcache-gcron.php
if ( !defined('DOCKET_CACHE_GCRON_DISABLED') || !DOCKET_CACHE_GCRON_DISABLED) {
    exit;
}

add_action('docketcache_custom_gcron', function() {
    if ( has_filter('docketcache/filter/garbagecollector') ) {
        $results = apply_filters('docketcache/filter/garbagecollector', true);
        if (!empty($results) && \is_object($results)) {
            if ($results->is_locked) {
                // Process is locked.
                return;
            }
            // Process is Ok.
        }
    }
});

if (!wp_next_scheduled('docketcache_custom_gcron')) {
    wp_schedule_event(time(), 'hourly', 'docketcache_custom_gcron');
}

DOCKET_CACHE_DISABLED

Set to true to disable the Docket Cache object cache feature at runtime. By defining it as true, Docket Cache will ignore to install and uninstall the Drop-in file. Default:

define('DOCKET_CACHE_DISABLED', false);