CGI::Cache 1.04 Perl extension to help cache output of time- intensive CGI scripts so that subsequent visits to such scripts will not cost as much time. WARNING! The interface in this version of CGI::Cache is incompatible with the interface of version 1.00 and earlier. You will need to modify any existing scripts you have to use the new interface if you install this version. WARNING! The interface changed slightly in version 1.20. NEW IN THIS VERSION 1.20 - Added a FORCE_INSTALL option to Makefile.PL to skip warnings about possibly incompatible versions. - Many thanks to Benjamin Goldberg for helping to fix the tie'ing of STDOUT so that it works well with FastCGI. CGI::Cache is now fully compatible with FastCGI and mod_perl, and no extra work needs to be done on the part of the user. Thanks also to "doggy" for raising the issue. - Migrated over to Cache::Cache from File::Cache. The interface has changed slightly, and is not fully backward compatible with previous versions. - Changed test script to use the same perl interpreter for testing as the one that was used to run the test script itself. (Thanks to Honza Pazdziora for the patch.) - Added features to explictly identify the handles to monitor and the handles upon which to output. This allows CGI::Cache to interoperate better with other modules which attempt to bind to STDOUT and STDERR, and allows the user to cache output to files. - Side-effects of CGI::Cache (tie'ing of handles, rebinding of warn() and die()) now only occur when CGI::Cache is actually caching output. - CGI::Cache::start() now returns 0 instead of exiting after cached output is printed. This provides better compatibility with persistent CGI scripts implemented using mod_perl or FastCGI. - Added several new test cases MODULE DEPENDENCIES You will need to install Cache::Cache to use CGI::Cache. You can get the latest version from: http://www.perl.com/CPAN/authors/id/D/DC/DCLINTON/ Alternatively, installation of Cache::Cache and its dependencies can be done automatically using the CPAN module: perl -MCPAN -e 'install Cache::Cache' INSTALLATION To install this package, change to the directory where you unarchived this distribution and type the following: perl Makefile.PL make make test make install You can also use "perl Makefile.PL FORCE_INSTALL" to avoid prompts which ask if it is okay to install the new version even if it is potentially incompatible with scripts written using the older version found on the system. During the 'make test', there are some tests that take a while longer to run. While testing that caching is working, CPU times are being recorded on some badly written code to see that performance will actually be increased on subsequent visits. Don't panic. It may take a couple of minutes to run, depending on your system. If you do not have root access on your machine, then you may not have the ability to install this module in the standard perl library path. You may direct the installation into your own space, e.g., perl Makefile.PL LIB='/home/userid/lib' or perhaps the entire installation, e.g., perl Makefile.PL PREFIX='/home/userid' If you make the installation into your own directory, then remember that you must tell perl where to search for modules before trying to 'use' them. For example: use lib '/home/userid/lib'; use CGI::Cache; NOTES Please let me know if you are using this module. Tell me what bugs you find or what can be done to improve it. HOMEPAGE Visit http://cgicache.sourceforge.net/ for the latest version, mailing lists, discussion forums, CVS access, and more. COPYRIGHT Copyright (c) 1998-Sep 1 2000 Broc Seib. Copyright (c) Sep 1 2000-2001 David Coppit. All rights reserved. LICENSE This code is distributed under the GNU General Public License (GPL). See http://www.opensource.org/gpl-license.html and http://www.opensource.org/. AUTHOR David Coppit, david@coppit.org (current maintainer) Broc Seib, bseib@purdue.edu (original author)