Update: jyurek wrote, “I’ll likely pull this in soon. Thanks for your work.”

One of the tricks to improving the performance of your website is to optimize caching. By instructing browsers and proxies to cache assets that don’t change very often (css, images, javascript), we can reduce page load time as well as bandwidth costs.

By instructing browsers and proxies not to check for updated versions of cached assets we can further speed things up. Google recommend the use of fingerprinting to enable dynamic updating of cached content. This simply means including a fingerprint of the resource in it’s URL so the URL gets updated when the resource changes.

Paperclip is a popular file attachment plugin for Ruby on Rails. It was a perfect candidate for fingerprinting support as it generates resource URLs from stored data. Enabling it is as simple as:

1. configure your app to use mbailey-paperclip
2. add an :attachment_fingerprint column to your database
3. include :fingerprint in the path for your attachment (see below)

      has_attached_file :avatar,
        :styles => { :medium => "300x300>", :thumb => "100x100>" },
        :path => "users/:id/:attachment/:fingerprint-:style.:extension",
        :storage => :s3,
        :s3_headers => {'Expires' => 1.year.from_now.httpdate},
        :s3_credentials => "#{RAILS_ROOT}/config/s3.yml",
        :include_updated_timestamp => false

This enables us to set far future expire headers so that browsers don’t need to check for a newer version. If a change does occur, say because a user uploads a new avatar, the new filename will be rendered in your html and the cached version will be ignored.

The example above will set Expires headers in S3. If you’re using local storage you can configure your webserver to do something similar.

We disable the timestamped query string because some proxies refuse to cache items with query strings.

Hopefully this change will be accepted upstream but in the meantime you can find it in this github commit.

For more info on optimizing for caching:

http://code.google.com/speed/page-speed/docs/caching.html