method

expire_page

v2.1.0 - Show latest stable - Class: ActionController::Caching::Pages

expire_page(options = {})

public

Expires the page that was cached with the options as a key. Example:

  expire_page :controller => "lists", :action => "show"

# File actionpack/lib/action_controller/caching/pages.rb, line 114
      def expire_page(options = {})
        return unless perform_caching

        if options.is_a?(Hash)
          if options[:action].is_a?(Array)
            options[:action].dup.each do |action|
              self.class.expire_page(url_for(options.merge(:only_path => true, :skip_relative_url_root => true, :action => action)))
            end
          else
            self.class.expire_page(url_for(options.merge(:only_path => true, :skip_relative_url_root => true)))
          end
        else
          self.class.expire_page(options)
        end
      end

1Note

When using RESTful routes

bjeanes · Aug 28, 20083 thanks

I had issues using +expire_page+ with RESTful controllers when expiring anything other than the index action because I was basing my +expire_page+ calls off this example.

The solution is to use +my_resource_path+ for example when +User+ with id 5 is updated, you would have to do:

expire_page user_path(user) # or
expire_page formatted_user_path(user, :xml)

This may apply to early versions but I have only tested on v2.1.0

expire_page

1Note

When using RESTful routes

Related methods