MySQL based Cache-Driver

1.3.2 2022-12-11 19:09 UTC

This package is auto-updated.

Last update: 2024-07-11 22:32:02 UTC


Release Downloads Build Status Coverage Status Maintainability Twitter

Dolphin - a MySQL Cache Driver for Kirby 3

Commerical Usage

Support open source!

This plugin is free but if you use it in a commercial project please consider to sponsor me or make a donation.
If my work helped you to make some cash it seems fair to me that I might get a little reward as well, right?

Be kind. Share a little. Thanks.

‐ Bruno


  • unzip as folder site/plugins/kirby3-mysql-cachedriver or
  • git submodule add site/plugins/kirby3-mysql-cachedriver or
  • composer require bnomei/kirby3-mysql-cachedriver


Cache methods

$cache = \Bnomei\MySQLCache::singleton(); // or
$cache = dolphin();

$cache->set('key', 'value', $expireInMinutes);
$value = dolphin()->get('key', $default);



mysql : 0.03287492121384
file : 0.11837792396545

ATTENTION: This will create and remove a lot of cache files and sqlite entries

No cache when debugging

When Kirbys global debug config is set to true the complete plugin cache will be flushed and no caches will be read. But entries will be created. This will make you live easier – trust me.

How to use MySQL Cache with Lapse or Boost

You need to set the cache driver for the lapse plugin to mysql.


return [
    'bnomei.lapse.cache' => ['type' => 'mysql'],
    'bnomei.boost.cache' => ['type' => 'mysql'],
    //... other options

Setup Content-File Cache

Use Kirby 3 Boost to setup a cache for content files.


You can set the host, dbname, username, password,... in the config.


return [
    // other config settings ...
    'bnomei.mysql-cachedriver.dbname' => 'YOUR-DBNAME-HERE',
    'bnomei.mysql-cachedriver.username' => 'YOUR-USERNAME-HERE',
    'bnomei.mysql-cachedriver.password' => 'YOUR-PASSWORD-HERE',

You can also set a callback if you use the dotenv Plugin.


return [
    // other config settings ...
    'bnomei.mysql-cachedriver.dbname' => function() { return env('MYSQL_DBNAME'); },
    'bnomei.mysql-cachedriver.username' => function() { return env('MYSQL_USERNAME'); },
    'bnomei.mysql-cachedriver.password' => function() { return env('MYSQL_PASSWORD'); },


  • PHP MySQL extension


This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.



It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.