Debian Codegraph @

docs/html/apreq_faq.html

raw
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> &gt; <a href="http://httpd.apache.org">HTTP Server Project</a> &gt;
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&amp;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 &quot;undefined symbol&quot; 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 &quot;[error] Can&#39;t locate .../Apache2/Request/upload.al in @INC&quot;?</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 &quot;undefined symbol&quot; 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 &quot;AddInputFilter APREQ&quot; 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 &quot;[error] Can&#39;t locate .../Apache2/Request/upload.al in @INC&quot;?</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 &quot;Can&#39;t locate auto/APR/Request/Param/slurp.al in @INC&quot;. 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&#39;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&#39;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 &copy; 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>