Strapi plugin static-file-route

Configure routes and directories for static files in strapi.

Configuration

Configure the plugin in config/plugins.js by setting an object-property with the name as the plugin

module.exports = ({ env }) => ({
  // ...
  'static-file-route': {
    config: {
      urlPath: '/static/files', // required
      rootDir: '/data/www/files', // required, an abosulte path or a path relative to strapis ./public/ dir
      cacheControl: { // optional
        private: true,
        noStore: false
      }
    }
  }
  // ...
});

Files in /data/www/files can now be accessed by DOMAIN-NAME/static/files/NAME-OF-FILE e.g. http://localhost:1337/static/files/demo.png.

If multiple root directories is required config can be set to an array of objects.

Cache-Control

Cache-Control can be configured by setting a cacheControl object on the configuration.

let config = {
    rootDir: '...',
    urlPath: '',
    cacheControl: {
        private: false, // set to 'true'  to only use private cache
        noStore: false // set to 'true' if no cache should be used at all
    }
}

If config.cacheControl.noStore is false an ETag is created to improve performance of fetching data.

Changing the Upload Local Dir

When using the strapi upload plugin and media library the default upload dir for local file system uploads is fixed to the ./public/uploads dir located in the root of the strapi project. To change this @chcaa/strapi-provider-upload-local-configurable can be used.