Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rtomayko/rack-cache
Real HTTP Caching for Ruby Web Apps
https://github.com/rtomayko/rack-cache
Last synced: 14 days ago
JSON representation
Real HTTP Caching for Ruby Web Apps
- Host: GitHub
- URL: https://github.com/rtomayko/rack-cache
- Owner: rtomayko
- License: other
- Created: 2008-10-25T02:02:09.000Z (about 16 years ago)
- Default Branch: master
- Last Pushed: 2022-03-04T03:57:50.000Z (over 2 years ago)
- Last Synced: 2024-07-31T20:49:34.119Z (3 months ago)
- Language: Ruby
- Homepage: http://rtomayko.github.io/rack-cache/
- Size: 930 KB
- Stars: 824
- Watchers: 19
- Forks: 126
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: MIT-LICENSE
Awesome Lists containing this project
- awesome-ruby - rack-cache
README
# Moved to https://github.com/rack/rack-cache
Rack::Cache
===========
Rack::Cache is suitable as a quick drop-in component to enable HTTP caching for
Rack-based applications that produce freshness (Expires, Cache-Control) and/or
validation (Last-Modified, ETag) information:
* Standards-based (RFC 2616)
* Freshness/expiration based caching
* Validation (If-Modified-Since / If-None-Match)
* Vary support
* Cache-Control: public, private, max-age, s-maxage, must-revalidate,
and proxy-revalidate.
* Portable: 100% Ruby / works with any Rack-enabled framework
* Disk, memcached, and heap memory storage backends
For more information about Rack::Cache features and usage, see:
https://rtomayko.github.com/rack-cache/
Rack::Cache is not overly optimized for performance. The main goal of the
project is to provide a portable, easy-to-configure, and standards-based
caching solution for small to medium sized deployments. More sophisticated /
high-performance caching systems (e.g., Varnish, Squid, httpd/mod-cache) may be
more appropriate for large deployments with significant throughput requirements.
Installation
------------
gem install rack-cache
Basic Usage
-----------
`Rack::Cache` is implemented as a piece of Rack middleware and can be used with
any Rack-based application. If your application includes a rackup (`.ru`) file
or uses Rack::Builder to construct the application pipeline, simply require
and use as follows:
```Ruby
require 'rack/cache'
use Rack::Cache,
metastore: 'file:/var/cache/rack/meta',
entitystore: 'file:/var/cache/rack/body',
verbose: true
run app
```
Assuming you've designed your backend application to take advantage of HTTP's
caching features, no further code or configuration is required for basic
caching.
Using with Rails
----------------
```Ruby
# config/application.rb
config.action_dispatch.rack_cache = true
# or
config.action_dispatch.rack_cache = {
verbose: true,
metastore: 'file:/var/cache/rack/meta',
entitystore: 'file:/var/cache/rack/body'
}
```
You should now see `Rack::Cache` listed in the middleware pipeline:
rake middleware
[more information](https://snippets.aktagon.com/snippets/302-how-to-setup-and-use-rack-cache-with-rails)
Using with Dalli
----------------
Dalli is a high performance memcached client for Ruby.
More information at: https://github.com/mperham/dalli
```Ruby
require 'dalli'
require 'rack/cache'
use Rack::Cache,
verbose: true,
metastore: "memcached://localhost:11211/meta",
entitystore: "memcached://localhost:11211/body"
run app
```
Noop entity store
-----------------
Does not persist response bodies (no disk/memory used).
Responses from the cache will have an empty body.
Clients must ignore these empty cached response (check for X-Rack-Cache response header).
Atm cannot handle streamed responses, patch needed.
```Ruby
require 'rack/cache'
use Rack::Cache,
verbose: true,
metastore:
entitystore: "noop:/"
run app
```
Ignoring tracking parameters in cache keys
-----------------
It's fairly common to include tracking parameters which don't affect the content
of the page. Since Rack::Cache uses the full URL as part of the cache key, this
can cause unneeded churn in your cache. If you're using the default key class
`Rack::Cache::Key`, you can configure a proc to ignore certain keys/values like
so:
```Ruby
Rack::Cache::Key.query_string_ignore = proc { |k, v| k =~ /^(trk|utm)_/ }
```
License: MIT
[](https://travis-ci.org/rtomayko/rack-cache)