What is this about ? ******************** Ensure that the PHP browscap is up to date from Gary Joel Keith's web site. This is used by the php function get_browser(); the database changes frequently, as frequently as weekly. This is intended to be run from cron. The web server (Apache) is restarted. Gary's site is here: http://browsers.garykeith.com/downloads.asp Installation ************ Copy the file UpdateBrowsCap.sh to /usr/local/bin/ and make it executable. Note that this script uses the Korn Shell (ksh), you may need to install this on your machine. You need to drive this from cron, something like the following will do: 3 7 * * 0 /usr/local/bin/UpdateBrowsCap This should be for a user who can write to the directory that contains the browscap file. PLEASE change the times in the cron line above, we don't want everyone to visit Gary's site at the same time. If we all come at different times we will hopefully not overload the site. If you install this package from the RPM the cron job is installed into root's crontab for you. The install process computes a random: minute, hour, day-of-week - to be nice to Gary's site. The RPM install will also update the php.ini file and restart the web server. PHP Configuration ***************** Your php.ini file, you need to have a line like: browscap = /var/lib/php/browscap.ini This is needed before get_browser() will work, the UpdateBrowsCap.sh script looks for it to determine the browscap directory. The file LastUpdated will be created in that directory (/var/lib/php/ -- or whatever) with the date that Gary last updated Browscap. Options ******* -b file Browscap is file -- this is for the rare situation where it is not mentioned in the default configuration, perhaps you do not have administrative access and need to install in your own directory. -d Do not restart the web server (default is to restart it) --force Force a new download of the browscap database, even if it does not appear to have changed. -k As --insecure --insecure Turn off curl's verification of the HTTPS server certificate. This might be needed if downloading the files (with the curl program) failes because curl cannot verify the certificate. -v Verbose mode - this program is usually silent -x eXplain --help As -x Errors ****** If it does not appear to be working: Switch on the -v option - to see where it is failing. Try --force to ignore the date on the database. If you see error messages - they are probably from curl. Curl error messages are numbered which makes it easy to work out which is which. License ******* This software is copyright (c) Alain Williams , 2007, 2008, 2011, 2012. This software is released under the GPLv3, see: http://www.gnu.org/licenses/gpl-3.0.html Keeping up to date ****************** You may find newer versions of this software at: http://www.phcomp.co.uk/downloads.php Where you will also find references to email lists that relate to this software. Contributing ************ UpdateBrowsCap is free software (see the license). Free software grows and becomes more powerful and useful as those who gain by using it contribute their changes back to the original author. Contributions to this software are welcome. Please email the author the following: * your name & email address * your affiliation (company/institute/...) if any * the code * documentation * a statement that you are legally able to release the code and documentation * a statement transfering copyright of the code to the Author below giving permission that it may be redistributed as part of UpdateBrowsCap under an appropriate license Contributions will be acknowledged in the Contributors file that accompanies this software. If you do not want to be acknowledged please make that clear. The author will be pleased to receive your comments, good or bad. SCCS: @(#)README 1.16 06/20/12 10:28:39