rbowen 02/01/20 08:39:41
Modified: htdocs/manual/mod mod_include.html
Log:
Based on a discussion on usenet, a little more detail regarding exec cgi
and include virtual, with a few examples.
Revision Changes Path
1.39 +19 -3 httpd-docs-1.3/htdocs/manual/mod/mod_include.html
Index: mod_include.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_include.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- mod_include.html 20 Jan 2002 14:43:56 -0000 1.38
+++ mod_include.html 20 Jan 2002 16:39:41 -0000 1.39
@@ -200,7 +200,8 @@
output, then this will be translated into an HTML
anchor.</p>
- <p>The <code>include virtual</code> element should be
+ <p>The <code><a href="#includevirtual">include
+ virtual</a></code> element should be
used in preference to <code>exec cgi</code>. In particular,
if you need to pass additional arguments to a CGI program,
using the query string, this cannot be done with <code>exec
@@ -219,7 +220,8 @@
to the command, in addition to the usual set of CGI
variables.</p>
- <p>The use of <code>#include virtual</code> is almost always
+ <p>The use of <code><a href="#includevirtual">#include
+ virtual</a></code> is almost always
prefered to using either <code>#exec cgi</code> or <code>#exec
cmd</code>. The former (<code>#include virtual</code>) used the
standard Apache sub-request mechanism to include files or
@@ -291,10 +293,13 @@
<dd>The value is a path relative to the directory
containing the current document being parsed. It cannot
contain <code>../</code>, nor can it be an absolute path.
+ Therefore, you cannot include files that are outside of the
+ document root, or above the current document in the directory
+ structure.
The <code>virtual</code> attribute should always be used
in preference to this one.</dd>
- <dt><strong>virtual</strong></dt>
+ <dt><strong><a name="includevirtual">virtual</a></strong></dt>
<dd>
<p>The value is a (%-encoded) URL relative to the
@@ -307,6 +312,17 @@
server would return if the URL were accessed by the client
is included in the parsed output. Thus included files can
be nested.</p>
+
+ <p>If the specified URL is a CGI program, the program will
+ be executed and its output inserted in place of the directive
+ in the parsed file. You may include a query string in a CGI
+ url:</p>
+
+ <code><!--#include virtual="/cgi-bin/example.cgi?argument=value"
--></code>
+
+ <p><code>include virtual</code> should be used in preference
+ to <code>exec cgi</code> to include the output of CGI
+ programs into an HTML document.
</dd>
</dl>
</dd>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
