Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Cache render calls in Rails controllers.
branch: master


= Render Caching

Cache render calls in Rails controllers.

== Install

First install the gem.

  gem install ryanb-render-caching --source=

Then specify it in your Rails config.

	config.gem 'ryanb-render-caching', :lib => 'render_caching', :source => ''

Rails 2.1 or later required.

== Usage

This gem adds the render_with_cache method to all controllers. Call 
this inside of an action to cache the view.

	def show
	  @user = User.find(params[:id])

This will cache the full rendered contents into a key matching the URL 
path (similar to action caching). You can change this key by simply 
passing any parameter.

	def show
	  @user = User.find(params[:id])
	  render_with_cache @user.cache_key

Cache key is a method supplied by Rails. This includes the updated_at 
time which will give you an auto-expiring cache when the user record is 

You can also supply a block to the render call which will only get 
executed if there is no cache. Here is a good place to do any custom 
render calls.

	def show
	  @user = User.find(params[:id])
	  render_with_cache @user.cache_key do
	    render :layout => false

== Development

This project can be found on github at the following URL.

If you would like to contribute to this project, please fork the 
repository and send me a pull request.
Something went wrong with that request. Please try again.