Name
Create Per-Directory Config Structure
Synopsis
void *module_create_dir_config(pool *pPool,char *szDir)
This structure is called once per
module, with szDir
set to NULL
,
when the main host’s configuration is initialized
and again for each <Directory>
,
<Location>
, or
<File>
section in the Config files
containing a directive from this module, with
szPath
set to the directory. Any per-directory
directives found outside <Directory>
,
<Location>
, or
<File>
sections end up in the
NULL
configuration. It is also called when
.htaccess files are parsed, with the name of the
directory in which they reside. Because this function is used for
.htaccess files, it may also be called after the
initializer is called. Also, the core caches per-directory
configurations arising from .htaccess files for
the duration of a request, so this function is called only once per
directory with an .htaccess file.
If a module does not support per-directory configuration, any
directives that appear in a <Directory>
section override the per-server configuration unless precautions are
taken. The usual way to avoid this is to set the req
_overrides
member appropriately in the command
table — see later in this section.
The purpose of this function is to allocate and initialize the memory required for any per-directory configuration. It returns a pointer to the allocated memory. See Example 21-2 (1.3) for an excerpt from mod_rewrite.c.
Example
static void *config_perdir_create(pool *p, ...
Get Apache: The Definitive Guide, 3rd Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.