Your web site must be running on the Apache web server. You must also have PHP4 or PHP5 running on the server. Preferably, your web site should be running on a server that is using Linux as the operating system.
NOTE: This package will probably work OK on a Windows Server, however, as of the date of this writing, it has not been tested other than with several Linux Servers.
If you've downloaded the complete countryhtblock.tar.gz package or countryhtblock.zip package, then you have almost everything you need. You will also need one more file which contains all of the country and ip address info.
You have your choice of two different databases.
One can be downloaded from http://ip-to-country.webhosting.info. This file is called ip-to-country.csv and can be found in the downloads section of their website. On the website, the downloadable file is called ip-to-country.csv.zip.
The other one can be found at http://www.maxmind.com. This file is called GeoIPCountryWhois.csv once it is unzipped. In it's zipped format when you download it, it is called GeoIPCountryCSV.zip. It's also found as GeoIP-lite on the site. This is the free download. You can also use their more accurate GeoIP file from their paid service. Be sure to get the .csv version and not the binary version.
Whichever file you choose, be sure to unzip it and copy it to the directory you will be using for this package.
The file you download from one of these two souces is used just one time during the initial setup. The information database is built from the file and is used for the operation of the programs in this package.
However, once you begin using this package, you will want to check periodically for new updates to the database file that you choose to use. Both database files are updated approximately every month or so.
NOTE: For the rest of this documentation, the country database file you have chosen to use will be referred as the ".csv database file".
Here's a brief summary of what you need to do to get this entire package running:
Optionally (or instead): Run iptocountry.php to look up countries according to their IP address.
For a much more detailed installation description, keep reading...