www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-08-05 16:55:50 +03:00
Code Activity

Update

Browse Source 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1325823 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Daniel Gruno
2012-04-13 16:03:53 +00:00
parent 119df47801
commit 473cd5d074
1 changed files with 10 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/manual/developer/hooks.xml
View File

@@ -31,10 +31,10 @@
date.</p> date.</p>
</note> </note>
<p>In general, a hook function is one that Apache will call at <p>In general, a hook function is one that the Apache HTTP Server
some point during the processing of a request. Modules can will call at some point during the processing of a request.
provide functions that are called, and specify when they get Modules can provide functions that are called, and specify when
called in comparison to other modules.</p> they get called in comparison to other modules.</p>
</summary> </summary>
<section id="create"><title>Creating a hook function</title> <section id="create"><title>Creating a hook function</title>
@@ -110,8 +110,8 @@
<p>The first hook that does <em>not</em> return <code>DECLINED</code> <p>The first hook that does <em>not</em> return <code>DECLINED</code>
stops the loop and its return value is returned from the hook stops the loop and its return value is returned from the hook
caller. Note that <code>DECLINED</code> is the tradition Apache caller. Note that <code>DECLINED</code> is the traditional
hook return meaning "I didn't do anything", but it can be hook return value meaning "I didn't do anything", but it can be
whatever suits you.</p> whatever suits you.</p>
<p>Alternatively, all hooks can be run until an error occurs. <p>Alternatively, all hooks can be run until an error occurs.
@@ -163,7 +163,7 @@
</section> </section>
<section id="hooking-add"><title>Add a hook registering function</title> <section id="hooking-add"><title>Add a hook registering function</title>
<p>During initialisation, Apache will call each modules hook <p>During initialisation, the server will call each modules hook
registering function, which is included in the module registering function, which is included in the module
structure:</p> structure:</p>
@@ -198,9 +198,9 @@
order relative to each other, but, of course, all modules using order relative to each other, but, of course, all modules using
<code>APR_HOOK_FIRST</code> will be run before <code>APR_HOOK_MIDDLE</code> <code>APR_HOOK_FIRST</code> will be run before <code>APR_HOOK_MIDDLE</code>
which are before <code>APR_HOOK_LAST</code>. Modules that don't care which are before <code>APR_HOOK_LAST</code>. Modules that don't care
when they are run should use <code>APR_HOOK_MIDDLE</code>. <em>(I spaced when they are run should use <code>APR_HOOK_MIDDLE</code>. <em>These
these out so people could do stuff like <code>APR_HOOK_FIRST-2</code> values are spaced out, so that positions like <code>APR_HOOK_FIRST-2</code>
to get in slightly earlier, but is this wise? - Ben)</em></p> are possible to hook slightly earlier than other functions.</em></p>
<p>Note that there are two more values, <p>Note that there are two more values,
<code>APR_HOOK_REALLY_FIRST</code> and <code>APR_HOOK_REALLY_LAST</code>. These <code>APR_HOOK_REALLY_FIRST</code> and <code>APR_HOOK_REALLY_LAST</code>. These
@@ -229,7 +229,6 @@
ordering set by <code>APR_HOOK_<var>ORDER</var></code> is preserved, as far ordering set by <code>APR_HOOK_<var>ORDER</var></code> is preserved, as far
as is possible.</p> as is possible.</p>
<p class="cite"><cite>Ben Laurie</cite>, 15th August 1999</p>
</section> </section>
</section> </section>
</manualpage> </manualpage>