Lock store

Shopware uses Symfony's lock component to implement locking functionality. By default, Symfony will use a local lock store. This means in multi-machine (cluster) setups, naive file locks will break the system; therefore, it is highly recommended to use one of the supported remote stores.

Using Redis as a lock store

As Redis can already be used for caching, increment store, and session storage, you can also use that Redis host as a remote lock store. To use Redis, first you need to create a named redis connection as described in the Redis configuration guide. Then, you can configure the lock store to use that connection. Create a config/packages/lock.yaml file with the following content:

framework:
    lock: 'shopware.redis.connection.connection_name'

Alternatively, you can use the DSN directly in the configuration file, but this is not recommended as it does not allow connection reuse and not prefixing locks keys with the value of the REDIS_PREFIX environment variable.

framework:
    lock: 'redis://host:port'

Other lock stores

As Shopware uses Symfony's lock component, all lock stores supported by Symfony can be used. Keep in mind that you should always use a remote store if you host Shopware in a cluster setup. For a list of all available lock stores, refer to Symfony's documentation. There is also more detailed information on the configuration options.