Cache extension for Aimeos web shops and e-commerce solutions

2017.01.2 2017-01-10 10:13 UTC


Aimeos logo

Build Status Coverage Status Scrutinizer Code Quality HHVM Status

The Aimeos cache extension contains alternative cache implementations to the database caching of the core. They can be used by Aimeos web shops to offload generated HTML web site parts to other services like specialized key/value stores.

Table of contents


As every Aimeos extension, the easiest way is to install it via composer. If you don't have composer installed yet, you can execute this string on the command line to download it:

php -r "readfile('');" | php -- --filename=composer

Add the cache extension name to the "require" section of your composer.json (or your composer.aimeos.json, depending on what is available) file:

"require": [
    "aimeos/ai-cache": "dev-master",

Afterwards you only need to execute the composer update command on the command line:

composer update

If your composer file is named "aimeos.composer.json", you must use this:

COMPOSER=composer.aimeos.json composer update

These commands will install the Aimeos extension into the extension directory and it will be available immediately.


The ways of adding the required resource configuration depends on the software you are using because all have their own means to do that. Here are some examples:

Laravel (in config/shop.php):

return array(
    'resource' => array(
        'cache' => array(
            '<name>' => array(

Symfony (in app/config/config.yml):


TYPO3 (via TypoScript in the setup template):

plugin.tx_aimeos.settings.resource.cache {
    <name>: {


Redis is an in-memory caching server known for its speed and advanced features. It supports not only plain key/value pairs but also lists for values used by Aimeos for tagging cached entries. This allows a fine control of removing outdated HTML parts.

After you've set up a Redis server, you need to tell your Aimeos shop installation how to connect to this server. The cache extension is using the Predis library and supports all configuration options available. The resource configuration consists of the name "redis" ( in the introduction to the config section) and the list of configuration key/value pairs, e.g.


                scheme: tcp
                port: 6379


plugin.tx_aimeos.settings.resource.cache {
    redis: {
        scheme = tcp
        host =
        port = 6379

Please have a look at the fine Predis readme for all available options.


The Aimeos cache extension is licensed under the terms of the LGPLv3 Open Source license and is available for free.