register¶

  # Mojolicious
  $app->plugin(CHI => {
    MyCache => {
      driver     => 'FastMmap',
      root_dir   => '/cache',
      cache_size => '20m'
    },
    default => {
      driver => 'Memory',
      global => 1
    },
    namespaces => 1
  });
  # Mojolicious::Lite
  plugin 'CHI' => {
    default => { driver => 'Memory', global => 1 }
  };
  # Or in your config file
  {
    CHI => {
      default => {
        driver => 'Memory',
        global => 1
      }
    }
  }

Called when registering the plugin. On creation, the plugin accepts a hash of cache names associated with CHI objects. All cache handles are qualified CHI namespaces. You can omit this mapping by passing a "namespaces" parameter with a "false" value. The handles have to be unique, i.e. you can't have multiple different "default" caches in mounted applications using Mojolicious::Plugin::Mount. Logging defaults to the application log, but can be overridden using on_get_error and on_set_error.

All parameters can be set as part of the configuration file with the key "CHI" or on registration (that can be overwritten by configuration).

Use custom CHI subclasses by passing a "chi_class" parameter with the class name of a CHI subclass.

chi¶

  # In Controllers:
  $c->chi('MyCache')->set(my_key => 'This is my value', '10 min');
  print $c->chi('MyCache')->get('my_key');
  print $c->chi->get('from_default_cache');

Returns a CHI handle if registered. Accepts the name of the registered cache. If no cache handle name is given, a cache handle name "default" is assumed.

chi list¶

  perl app.pl chi list

List all CHI caches associated with your application.

chi purge¶

  perl app.pl chi purge mycache

Remove all expired entries from the cache namespace.

chi clear¶

  perl app.pl chi clear mycache

Remove all entries from the cache namespace.

chi expire¶

  perl app.pl chi expire mykey
  perl app.pl chi expire mycache mykey

Set the expiration date of a key to the past. This does not necessarily delete the data, but makes it unavailable using "get".

chi remove¶

  perl app.pl chi remove mykey
  perl app.pl chi remove mycache mykey

Remove a key from the cache.