Skip to content
Rack::GeoIPCountry uses the geoip gem and the GeoIP database to lookup the country of a request by its IP address
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib version bump Apr 5, 2012
.gitignore initial import Feb 14, 2011
Gemfile initial import Feb 14, 2011
README.markdown readme added Feb 14, 2011
Rakefile initial import Feb 14, 2011
rack-geoipcountry.gemspec use the latest geoip version to make sure Mar 29, 2012

README.markdown

Rack::GeoIPCountry uses the geoip gem and the GeoIP database to lookup the country of a request by its IP address

The database can be downloaded from:

http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz

Usage

use Rack::GeoIPCountry, :db => "path/to/GeoIP.dat"

By default all requests are looked up and the X_GEOIP_* headers are added to the request The headers can then be read in the application. The country name is added to the request header as X_GEOIP_COUNTRY, eg: X_GEOIP_COUNTRY: United Kingdom

The full set of GEOIP request headers is below:

  • X_GEOIP_COUNTRY_ID - The GeoIP country-ID as an integer, if not found set to 0
  • X_GEOIP_COUNTRY_CODE - The ISO3166-1 two-character country code, if not found set to --
  • X_GEOIP_COUNTRY_CODE3 - The ISO3166-2 three-character country code, if not found set to --
  • X_GEOIP_COUNTRY - The ISO3166 English-language name of the country, if not found set to N/A
  • X_GEOIP_CONTINENT - The two-character continent code, if not found set to --

You can use the included Mapping class to trigger lookup only for certain requests by specifying matching path prefix in options, eg:

use Rack::GeoIPCountry::Mapping, :prefix => '/video_tracking'

The above will lookup IP addresses only for requests matching /video_tracking etc.

License

MIT License - Karol Hosiawa ( http://twitter.com/hosiawak )

Something went wrong with that request. Please try again.