@strapi/provider-upload-localis in use for uploading assets viaMedia Libraryin Strapi (default)- The need for configurable cache-control HTTP response headers (e.g.
cache-control: max-age=1234) + ETag HTTP response header for each asset - More information and differences between
koa-static(used in@strapi/provider-upload-local) andkoa-static-cache(used in this middleware-plugin) can be found here
Strapi 4.3 had breaking changes with asset organization through folders.
Make sure you are using at least v2.1.0 of this library with Strapi 4.3+!
Using npm
npm install strapi-middleware-upload-plugin-cache
Using yarn
yarn add strapi-middleware-upload-plugin-cache
Using npm
npm install strapi-middleware-upload-plugin-cache@2.0.0
Using yarn
yarn add strapi-middleware-upload-plugin-cache@2.0.0
Version 2.X.X+ of this library is NOT compatible with Strapi v3!
Please make sure to check out the Strapi v3 Docs for the installation & setup.
For Strapi, add a plugins.js file within the config folder
e.g.
touch config/plugins.js
containing
module.exports = {
"upload-plugin-cache": {
enabled: true,
config: {
maxAge: 86_400_000,
},
}
};
Starting Strapi in dev-mode should log the following:
[2022-02-22 22:22:22.222] debug: [upload-plugin-cache] Initializing ...
[2022-02-22 22:22:22.222] debug: [upload-plugin-cache] Middleware initialized for endpoint='/uploads/(.*)' [maxAge=300000]
With the option dynamic: true files which are not cached on initializations are dynamically loaded. To avoid OOM errors a LRU-cache can be used. For config options of lru-cache use these docs and insert them at lruCache.
module.exports = {
"upload-plugin-cache": {
enabled: true,
config: {
maxAge: 86_400_000,
dynamic: true,
lruCache: {
max: 1000
},
},
}
};