Configuring Cache Expiration for File System & Sitecore Media based on Production Deployments

Posted 08/18/2016 by Subramanian Ramanathan

While working with the Cache configuration for our website, we found that Sitecore’s media files have the "Expires" and "ETag" set in their cache headers. This is good! But we do not have these two settings for the File System Media like Stylesheets, Script Files and Static Image files. As a result, whenever we have a production release, users will have to refresh their cache to get the latest updates.

While working on this we found ‘MediaResponse.MaxAge’ setting for the Sitecore Media files, which we can update based on the next production release. But we do not have any such property for File System Media.

For setting the appropriate cache headers for the file system media, we will have to add custom handlers under customHandlers section and patch it into web.config file.

We have our Scripts, Stylesheets etc. in the Assets folder, so url for them will contain ‘/Assets/’. We can also have separate handlers for Images, Scripts, Stylesheets etc.

And the handler definition has to be added under system.webServer/handlers

And our custom Handler looks like this,

public class FileSystemMediaRequestHandler : IHttpHandler, IRequiresSessionState
   public bool IsReusable
      get { return true; }
   public void ProcessRequest(HttpContext context)
      HttpCachePolicy cache = context.Response.Cache;
      //Get the Next Production Deployment Date from Sitecore and add it to a Session Variable
      DateTime nextProductionDeployment = ((DateField)Utilities.GetItem(....).Fields["Next Production Deployment"]).DateTime;
      if(nextProductionDeployment < DateTime.Now)
         //Set Default Cache Expiration if the Next Production Deployment date is not updated
         cache.SetMaxAge(new TimeSpan(7, 0, 0, 0));
         TimeSpan span = nextProductionDeployment - DateTime.Now;
      context.Response.ContentType = MimeMapping.GetMimeMapping(context.Request.RawUrl);

I have kept the Next Production Deployment Date in Sitecore, and the expiration date of every media is calculated based on this value. We will have to add this value to a Session Variable(by implementing IRequiresSessionState interface) to avoid frequent hits to Sitecore.
We will also have to set the parameters like Last Modified Date and ETag for every media’s cache headers.

The same configuration can be followed for Sitecore Media too. We can create our custom handler for Sitecore’s MediaRequest and override the SendMediaHeaders Method. Necessary changes have to be made to web.config(sitecore_media.ashx)

public class CustomMediaRequestHandler : MediaRequestHandler, IRequiresSessionState
   protected override void SendMediaHeaders(Media media, HttpContext context)
      //Cache Configuration for Sitecore Media goes here..

Thus we have created a common place in Sitecore, for updating the Cache Expiration & related configurations for Sitecore & FileSystem Media.

But what if we have an unplanned production move, our configurations will have to accommodate that as well. For this we can create another date field in Sitecore (may be ‘Last Production Modified Date’) which will be updated when we do any changes to Sitecore Media or File System Media. We can store this date in a Cookie in user’s machine, and whenever cookie value and Sitecore date field value does not match, we will have to do a Response.Redirect(may be Sitecore.WebUtil.Redirect) or window.location.reload() to the same page. This will automatically download the latest version of media files along with our updated Cache Headers.


Add your comment