Apache Hooks
[Apache Core]

関数
int	get_mgmt_items (apr_pool_t *p, const char *val, apr_hash_t *ht)
void	error_log (const char *file, int line, int level, apr_status_t status, const server_rec *s, const request_rec *r, apr_pool_t *pool, const char *errstr)
void	insert_error_filter (request_rec *r)
int	create_request (request_rec *r)
int	translate_name (request_rec *r)
int	map_to_storage (request_rec *r)
int	check_user_id (request_rec *r)
int	fixups (request_rec *r)
int	type_checker (request_rec *r)
int	access_checker (request_rec *r)
int	auth_checker (request_rec *r)
void	insert_filter (request_rec *r)
int	pre_mpm (apr_pool_t *p, ap_scoreboard_e sb_type)

---

関数

int access_checker

(

request_rec *

r

)

This hook is used to apply additional access control to this resource. It runs *before* a user is authenticated, so this hook is really to apply additional restrictions independent of a user. It also runs independent of 'Require' directive usage.

引数:

r

the current request

戻り値:

OK, DECLINED, or HTTP_...

int auth_checker

(

request_rec *

r

)

This hook is used to check to see if the resource being requested is available for the authenticated user (r->user and r->ap_auth_type). It runs after the access_checker and check_user_id hooks. Note that it will *only* be called if Apache determines that access control has been applied to this resource (through a 'Require' directive).

引数:

r

the current request

戻り値:

OK, DECLINED, or HTTP_...

int check_user_id

(

request_rec *

r

)

This hook is used to analyze the request headers, authenticate the user, and set the user information in the request record (r->user and r->ap_auth_type). This hook is only run when Apache determines that authentication/authorization is required for this resource (as determined by the 'Require' directive). It runs after the access_checker hook, and before the auth_checker hook.

引数:

r

The current request

戻り値:

OK, DECLINED, or HTTP_...

int create_request

(

request_rec *

r

)

Gives modules a chance to create their request_config entry when the request is created.

引数:

r

The current request

void error_log	(	const char *	file,
		int	line,
		int	level,
		apr_status_t	status,
		const server_rec *	s,
		const request_rec *	r,
		apr_pool_t *	pool,
		const char *	errstr
	)

hook method to log error messages

引数:

	file	The file in which this function is called
	line	The line number on which this function is called
	level	The level of this error message
	status	The status code from the previous command
	s	The server which we are logging for
	r	The request which we are logging for
	pool	Memory pool to allocate from
	errstr	message to log

int fixups

(

request_rec *

r

)

Allows modules to perform module-specific fixing of header fields. This is invoked just before any content-handler

引数:

r

The current request

戻り値:

OK, DECLINED, or HTTP_...

int get_mgmt_items	(	apr_pool_t *	p,
		const char *	val,
		apr_hash_t *	ht
	)

This hook provdes a way for modules to provide metrics/statistics about their operational status.

引数:

	p	A pool to use to create entries in the hash table
	val	The name of the parameter(s) that is wanted. This is tree-structured would be in the form ('*' is all the tree, 'module.*' all of the module , 'module.foo.*', or 'module.foo.bar' )
	ht	The hash table to store the results. Keys are item names, and the values point to ap_mgmt_item_t structures.

void insert_error_filter

(

request_rec *

r

)

This hook allows modules to insert filters for the current error response

引数:

r

the current request

void insert_filter

(

request_rec *

r

)

This hook allows modules to insert filters for the current request

引数:

r

the current request

int map_to_storage

(

request_rec *

r

)

This hook allow modules to set the per_dir_config based on their own context (such as "<Proxy>" sections) and responds to contextless requests such as TRACE that need no security or filesystem mapping. based on the filesystem.

引数:

r

The current request

戻り値:

DONE (or HTTP_) if this contextless request was just fulfilled (such as TRACE), OK if this is not a file, and DECLINED if this is a file. The core map_to_storage (HOOK_RUN_REALLY_LAST) will directory_walk and file_walk the r->filename.

int pre_mpm	(	apr_pool_t *	p,
		ap_scoreboard_e	sb_type
	)

Hook for post scoreboard creation, pre mpm.

引数:

	p	Apache pool to allocate from.
	sb_type

戻り値:

OK or DECLINE on success; anything else is a error

int translate_name

(

request_rec *

r

)

This hook allow modules an opportunity to translate the URI into an actual filename. If no modules do anything special, the server's default rules will be followed.

引数:

r

The current request

戻り値:

OK, DECLINED, or HTTP_...

int type_checker

(

request_rec *

r

)

This routine is called to determine and/or set the various document type information bits, like Content-type (via r->content_type), language, et cetera.

引数:

r

the current request

戻り値:

OK, DECLINED, or HTTP_...

---