mirror of
https://github.com/apache/httpd.git
synced 2026-01-26 19:01:35 +03:00
dbfc30e197
is common across any cache implementation, the other part is private to the particular implementation (eg, mem_cache_object_t/mod_mem_cache). Use a cache_handle_t allocated out of the request pool to hold references to the callback functions and common cache object. The cache_handle_t contains implementation specific callback functions and a reference to a common cache_object_t. The cache_object_t contains a reference to an implementation specific cache object extension (mem_cache_object_t for example). All this simplifies managing the callback function pointers (don't want to save them in each cache entry) and collections of cache_object_t keyed to a single url. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@90994 13f79535-47bb-0310-9956-ffa450edef68
README for Apache 2.0 Example Module
[April, 1997, updated May 2000]
The files in the src/modules/example directory under the Apache
distribution directory tree are provided as an example to those that
wish to write modules that use the Apache API.
The main file is mod_example.c, which illustrates all the different
callback mechanisms and call syntaces. By no means does an add-on
module need to include routines for all of the callbacks - quite the
contrary!
The example module is an actual working module. If you link it into
your server, enable the "example-handler" handler for a location, and then
browse to that location, you will see a display of some of the tracing
the example module did as the various callbacks were made.
To include the example module in your server run `./configure
--enable-example` in the src directory before running `make`.
To add another module of your own:
A. mkdir src/modules/mymodule
B. cp src/modules/example/* src/modules/mymodule
C. Modify the files in the new directory
D. Build the server as above, with appropriate changes.
To activate the example module, include a block similar to the
following in your httpd.conf file:
<Location /example-info>
SetHandler example-handler
</Location>
As an alternative, you can put the following into a .htaccess file and
then request the file "test.example" from that location:
AddHandler example-handler .example
After reloading/restarting your server, you should be able to browse
to this location and see the brief display mentioned earlier.