| 1 |
<html> |
| 2 |
<head> |
| 3 |
<link rel="stylesheet" type="text/css" href="dox.css" /> |
| 4 |
<title>libapreq2-2.17: FAQ</title> |
| 5 |
</head> |
| 6 |
<body> |
| 7 |
<div id="page-header"> |
| 8 |
<p class="menu"> |
| 9 |
<a href="http://www.apache.org/">Apache Software Foundation</a> > <a href="http://httpd.apache.org">HTTP Server Project</a> > |
| 10 |
<a href="http://httpd.apache.org/apreq/">Request Library Subproject</a></p> |
| 11 |
<p class="apache">Apache HTTP Server Request Library</p> |
| 12 |
<img alt="" src="feather.gif" /></div> |
| 13 |
<!-- Generated by Doxygen 1.9.1 --> |
| 14 |
<script type="text/javascript" src="menudata.js"></script> |
| 15 |
<script type="text/javascript" src="menu.js"></script> |
| 16 |
<script type="text/javascript"> |
| 17 |
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ |
| 18 |
$(function() { |
| 19 |
initMenu('',false,false,'search.php','Search'); |
| 20 |
}); |
| 21 |
/* @license-end */</script> |
| 22 |
<div id="main-nav"></div> |
| 23 |
</div><!-- top --> |
| 24 |
<div class="PageDoc"><div class="header"> |
| 25 |
<div class="headertitle"> |
| 26 |
<div class="title">FAQ </div> </div> |
| 27 |
</div><!--header--> |
| 28 |
<div class="contents"> |
| 29 |
<div class="textblock"> |
| 30 |
|
| 31 |
|
| 32 |
|
| 33 |
<ul id="index"> |
| 34 |
<li><a href="#Issues-during-installation">Issues during installation.</a></li> |
| 35 |
<li><a href="#Using-libapreq2-with-Apache2-and-mod_perl2">Using libapreq2 with Apache2 and mod_perl2.</a> |
| 36 |
<ul> |
| 37 |
<li><a href="#I-keep-getting-undefined-symbol-errors-whenever-I-use-Apache2::Request-or-APR::Request::Apache2">I keep getting "undefined symbol" errors whenever I use Apache2::Request or APR::Request::Apache2.</a></li> |
| 38 |
<li><a href="#When-I-use-Apache2::Request-in-my-output-filter-it-seems-to-lose-the-incoming-POST-variables">When I use Apache2::Request in my output filter, it seems to lose the incoming POST variables.</a></li> |
| 39 |
<li><a href="#When-I-try-to-upload-a-file-why-do-I-get-this-error-error-Cant-locate-...-Apache2-Request-upload.al-in-INC">When I try to upload a file, why do I get this error "[error] Can't locate .../Apache2/Request/upload.al in @INC"?</a></li> |
| 40 |
</ul> |
| 41 |
</li> |
| 42 |
<li><a href="#Using-libapreq2-outside-of-Apache">Using libapreq2 outside of Apache.</a></li> |
| 43 |
<li><a href="#Contributing-to-apreq-development">Contributing to apreq development.</a> |
| 44 |
<ul> |
| 45 |
<li><a href="#How-is-the-subversion-repository-managed">How is the subversion repository managed?</a></li> |
| 46 |
</ul> |
| 47 |
</li> |
| 48 |
</ul> |
| 49 |
|
| 50 |
<h1 id="Issues-during-installation">Issues during installation.</h1> |
| 51 |
|
| 52 |
<p>[...]</p> |
| 53 |
|
| 54 |
<h1 id="Using-libapreq2-with-Apache2-and-mod_perl2">Using libapreq2 with Apache2 and mod_perl2.</h1> |
| 55 |
|
| 56 |
<h2 id="I-keep-getting-undefined-symbol-errors-whenever-I-use-Apache2::Request-or-APR::Request::Apache2">I keep getting "undefined symbol" errors whenever I use Apache2::Request or APR::Request::Apache2.</h2> |
| 57 |
|
| 58 |
<p>You need to load mod_apreq2.so at server startup, which grabs all the required symbols at server startup. Be sure your server config contains a line like</p> |
| 59 |
|
| 60 |
<pre><code>LoadModule apreq_module modules/mod_apreq2.so</code></pre> |
| 61 |
|
| 62 |
<h2 id="When-I-use-Apache2::Request-in-my-output-filter-it-seems-to-lose-the-incoming-POST-variables">When I use Apache2::Request in my output filter, it seems to lose the incoming POST variables.</h2> |
| 63 |
|
| 64 |
<p>The problem is likely that the mod_apreq2 filter has not been added to the input filter chain in time to read the POST data.</p> |
| 65 |
|
| 66 |
<p>There are two solutions to this problem:</p> |
| 67 |
|
| 68 |
<pre><code>1) Write a filter init handler for you filter that instantiates an |
| 69 |
Apache2::Request object. |
| 70 |
|
| 71 |
http://perl.apache.org/docs/2.0/api/Apache2/Filter.html#C_FilterInitHandler_ |
| 72 |
|
| 73 |
2) Use .htaccess or your server config to ensure the apreq input filter |
| 74 |
is active for this request with "AddInputFilter APREQ" or somesuch.</code></pre> |
| 75 |
|
| 76 |
<p>We recommend using (1), and falling back to (2) until you get (1) working.</p> |
| 77 |
|
| 78 |
<h2 id="When-I-try-to-upload-a-file-why-do-I-get-this-error-error-Cant-locate-...-Apache2-Request-upload.al-in-INC">When I try to upload a file, why do I get this error "[error] Can't locate .../Apache2/Request/upload.al in @INC"?</h2> |
| 79 |
|
| 80 |
<p><i>Apache2::Upload</i> is now a separate module in apreq2, so you need to <code>use Apache2::Upload</code> to load the <code>Apache2::Request::upload</code> function.</p> |
| 81 |
|
| 82 |
<p>This also applies to "Can't locate auto/APR/Request/Param/slurp.al in @INC". This is because <i>Apache2::Upload</i> is implement by wrapping the <i>APR::Request::*</i> packages.</p> |
| 83 |
|
| 84 |
<h1 id="Using-libapreq2-outside-of-Apache">Using libapreq2 outside of Apache.</h1> |
| 85 |
|
| 86 |
<p>[...]</p> |
| 87 |
|
| 88 |
<h1 id="Contributing-to-apreq-development">Contributing to apreq development.</h1> |
| 89 |
|
| 90 |
<h2 id="How-is-the-subversion-repository-managed">How is the subversion repository managed?</h2> |
| 91 |
|
| 92 |
<p>apreq's repository is broken into three subdirectories:</p> |
| 93 |
|
| 94 |
<pre><code>/trunk - the current codebase for active development. |
| 95 |
/tags - release snapshots. |
| 96 |
/branches - where older releases and experimental development lines live.</code></pre> |
| 97 |
|
| 98 |
<p>apreq follows a Commit-then-Review policy for its entire repository, but being a shared library places certain restrictions on the admissible changes for stable trees. Basically the header files cannot be modified; only new functions and structures may be added to them. Any time that happens, the minor-version needs to be bumped, and the patch-level gets reset to zero. Changes that only modify the library's implementation (.c) files require a bump to the patch-level. On stable trees, this version tracking should happen on each commit, to make auditing easy for other developers without resorting to a draconian Review-then-Commit policy.</p> |
| 99 |
|
| 100 |
|
| 101 |
</div></div><!-- contents --> |
| 102 |
</div><!-- PageDoc --> |
| 103 |
<div id="footer"> |
| 104 |
<p class="apache"> |
| 105 |
Copyright © 2003-2006 <a href="http://www.apache.org">The Apache Software Foundation</a>.<br/> |
| 106 |
See <a href="apreq_license.html">LICENSE</a>.</p> |
| 107 |
<p class="menu"> |
| 108 |
<span style="color:#aaa">page generated by <a href="http://www.doxygen.org/"><code>doxygen</code></a> |
| 109 |
version 1.9.1 on Thu Aug 18 2022</span> |
| 110 |
</p> |
| 111 |
</div> |
| 112 |
</body> |
| 113 |
</html> |