NAME Apache::Storage - Storing data in Apache. SYNOPSIS use Apache::Storage; DESCRIPTION Ever wanted to store information in Apache so the additional requests could gain access to it? For example, you create an object which is fairly expensive and you don't want to have to recreate each time, or say you just have some information you are storing in a reference that you want requests that follow you to see. This module is for you. It has three functions described below. They allow you to store and retrieve information from the Apache process. The functions are fairly simple and should make it pretty easy for you to do so without to much hassle. All of this works with subrequests, so unlike pnotes, you don't need to worry about loosing data if your request is subrequested by an outside Apache module. You can also use the ApacheStorage directive inside of Apache to prime data into the Apache::Storage. FUNCTIONS Note Keep in mind that data is only stored on the Apache process itself. Different child processes all have their own storage. Don't assume you will get the same Apache child process when reconnecting. Make sure you put a "PerlModule Apache::Storage" in your httpd.conf file. Apache make core if you do not do this. set_storage Set functions can be called in two ways. They can be called with a key and a reference. The reference will then be available by calling it through a get function. You can also pass in hash reference. The contents of this hash will be mapped into storage based on it original key pair. Nothing is returned by either of these functions get_storage Get functions can be calling in two ways. They can either be called with a single key, where they will return a single hash get_storage_dump This gives you a hash of the entire contents of what is being stored currently. Apache Directives ApacheStore Takes two arguments, a key and a value. The value is evaled. ApacheStorageInit Takes no values, and only needs to be used if you don't have at least one ApacheStore call. Example httpd.conf ServerAdmin root@tangent.org DocumentRoot /usr/local/apache/htdocs ServerName slash.tangent.org ErrorLog logs/error_log CustomLog logs/access_log common ApacheStoreINIT ServerAdmin root@tangent.org DocumentRoot /usr/local/apache/htdocs ServerName slash2.tangent.org ErrorLog logs/error_log CustomLog logs/access_log common ApacheStore foo "[qw(skdjf slkdjf lskdjf)]" LICENSE See the file LICENSE that this comes with. SEE ALSO perl(3). mod_perl(3). HOME http://tangent.org/Apache-Storage/ Author Brian Aker, brian@tangent.org Seattle, WA.