2323<manualpage metafile =" cgi.xml.meta" >
2424 <parentdocument href =" ./" >How-To / Tutorials</parentdocument >
2525
26- <title >Apache Tutorial: Dynamic Content with CGI</title >
26+ <title >Apache HTTP Server Tutorial: Dynamic Content with CGI</title >
2727
2828 <section id =" intro" >
2929 <title >Introduction</title >
4848 is a simple way to put dynamic content on
4949 your web site, using whatever programming language you're most
5050 familiar with. This document will be an introduction to setting
51- up CGI on your Apache web server, and getting started writing
51+ up CGI on your httpd web server, and getting started writing
5252 CGI programs.</p >
5353 </section >
5454
5555 <section id =" configuring" >
56- <title >Configuring Apache to permit CGI</title >
56+ <title >Configuring httpd to permit CGI</title >
5757
5858 <p >In order to get your CGI programs to work properly, you'll
59- need to have Apache configured to permit CGI execution. There
59+ need to have httpd configured to permit CGI execution. There
6060 are several ways to do this.</p >
6161
62- <note type =" warning" >Note: If Apache has been built with shared module
62+ <note type =" warning" >Note: If httpd has been built with shared module
6363 support you need to ensure that the module is loaded; in your
6464 <code >httpd.conf</code > you need to make sure the
6565 <directive module =" mod_so" >LoadModule</directive >
8585 <p >The
8686 <directive module =" mod_alias" >ScriptAlias</directive >
8787
88- directive tells Apache that a particular directory is set
89- aside for CGI programs. Apache will assume that every file in
88+ directive tells httpd that a particular directory is set
89+ aside for CGI programs. httpd will assume that every file in
9090 this directory is a CGI program, and will attempt to execute
9191 it, when that particular resource is requested by a
9292 client.</p >
@@ -99,7 +99,7 @@ ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
9999 </highlight >
100100
101101 <p >The example shown is from your default <code >httpd.conf</code >
102- configuration file, if you installed Apache in the default
102+ configuration file, if you installed httpd in the default
103103 location. The <directive module =" mod_alias" >ScriptAlias</directive >
104104 directive is much like the <directive module =" mod_alias"
105105 >Alias</directive > directive, which defines a URL prefix that
@@ -110,18 +110,18 @@ ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
110110 <directive >Alias</directive > and <directive >ScriptAlias</directive >
111111 is that <directive >ScriptAlias</directive > has the added meaning
112112 that everything under that URL prefix will be considered a CGI
113- program. So, the example above tells Apache that any request for a
113+ program. So, the example above tells httpd that any request for a
114114 resource beginning with <code >/cgi-bin/</code > should be served from
115115 the directory <code >/usr/local/apache2/cgi-bin/</code >, and should be
116116 treated as a CGI program.</p >
117117
118118 <p >For example, if the URL
119119 <code >http://www.example.com/cgi-bin/test.pl</code >
120- is requested, Apache will attempt to execute the file
120+ is requested, httpd will attempt to execute the file
121121 <code >/usr/local/apache2/cgi-bin/test.pl</code >
122122 and return the output. Of course, the file will have to
123123 exist, and be executable, and return output in a particular
124- way, or Apache will return an error message.</p >
124+ way, or httpd will return an error message.</p >
125125 </section >
126126
127127 <section id =" nonscriptalias" >
@@ -162,7 +162,7 @@ ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
162162< /Directory>
163163 </highlight >
164164
165- <p >The above directive tells Apache to permit the execution
165+ <p >The above directive tells httpd to permit the execution
166166 of CGI files. You will also need to tell the server what
167167 files are CGI files. The following <directive module =" mod_mime"
168168 >AddHandler</directive > directive tells the server to treat all
@@ -250,7 +250,7 @@ print "Hello, World.";
250250 </highlight >
251251
252252 <p >Even if you are not familiar with Perl, you should be able
253- to see what is happening here. The first line tells Apache
253+ to see what is happening here. The first line tells httpd
254254 (or whatever shell you happen to be running under) that this
255255 program can be executed by feeding the file to the
256256 interpreter found at the location <code >/usr/bin/perl</code >.
@@ -289,19 +289,19 @@ print "Hello, World.";
289289
290290 <dt >The source code of your CGI program or a "POST Method Not
291291 Allowed" message</dt >
292- <dd >That means that you have not properly configured Apache
292+ <dd >That means that you have not properly configured httpd
293293 to process your CGI program. Reread the section on
294294 <a href =" #configuring" >configuring
295- Apache </a > and try to find what you missed.</dd >
295+ httpd </a > and try to find what you missed.</dd >
296296
297297 <dt >A message starting with "Forbidden"</dt >
298298 <dd >That means that there is a permissions problem. Check the
299- <a href =" #errorlogs" >Apache error log</a > and the section below on
299+ <a href =" #errorlogs" >httpd error log</a > and the section below on
300300 <a href =" #permissions" >file permissions</a >.</dd >
301301
302302 <dt >A message saying "Internal Server Error"</dt >
303303 <dd >If you check the
304- <a href =" #errorlogs" >Apache error log</a >, you will probably
304+ <a href =" #errorlogs" >httpd error log</a >, you will probably
305305 find that it says "Premature end of
306306 script headers", possibly along with an error message
307307 generated by your CGI program. In this case, you will want to
@@ -372,7 +372,7 @@ print "Hello, World.";
372372
373373 <p >If your CGI program depends on non-standard <a
374374 href =" #env" >environment variables</a >, you will need to
375- assure that those variables are passed by Apache .</p >
375+ assure that those variables are passed by httpd .</p >
376376
377377 <p >When you miss HTTP headers from the environment, make
378378 sure they are formatted according to
@@ -399,13 +399,13 @@ print "Hello, World.";
399399 </example >
400400
401401 <p >(Do not call the <code >perl</code > interpreter. The shell
402- and Apache should find the interpreter using the <a
402+ and httpd should find the interpreter using the <a
403403 href =" #pathinformation" >path information</a > on the first line of
404404 the script.)</p >
405405
406406 <p >The first thing you see written by your program should be
407407 a set of HTTP headers, including the <code >Content-Type</code >,
408- followed by a blank line. If you see anything else, Apache will
408+ followed by a blank line. If you see anything else, httpd will
409409 return the <code >Premature end of script headers</code > error if
410410 you try to run it through the server. See <a
411411 href =" #writing" >Writing a CGI program</a > above for more
@@ -436,7 +436,7 @@ print "Hello, World.";
436436
437437 <p >To check if you are using suexec, run <code >apachectl
438438 -V</code > and check for the location of <code >SUEXEC_BIN</code >.
439- If Apache finds an <program >suexec</program > binary there on startup,
439+ If httpd finds an <program >suexec</program > binary there on startup,
440440 suexec will be activated.</p >
441441
442442 <p >Unless you fully understand suexec, you should not be using it.
@@ -473,7 +473,7 @@ print "Hello, World.";
473473 <p >During the CGI transaction, the server and the browser
474474 also set environment variables, so that they can communicate
475475 with one another. These are things like the browser type
476- (Netscape, IE , Lynx), the server type (Apache, IIS, WebSite ),
476+ (Chrome, Firefox , Lynx), the server type (Apache httpd, Nginx, IIS ),
477477 the name of the CGI program that is being run, and so on.</p >
478478
479479 <p >These variables are available to the CGI programmer, and
@@ -487,10 +487,10 @@ print "Hello, World.";
487487 similar programs are included in the
488488 <code >cgi-bin</code >
489489
490- directory of the Apache distribution. Note that some
490+ directory of the httpd distribution. Note that some
491491 variables are required, while others are optional, so you may
492492 see some variables listed that were not in the official list.
493- In addition, Apache provides many different ways for you to
493+ In addition, httpd provides many different ways for you to
494494 <a href =" ../env.html" >add your own environment variables</a >
495495 to the basic ones provided by default.</p >
496496
@@ -584,7 +584,7 @@ foreach my $key (keys %ENV) {
584584 make finding your problem much simpler.</p >
585585
586586 <p >Note that questions about CGI problems should <strong >never</strong >
587- be posted to the Apache bug database unless you are sure you
588- have found a problem in the Apache source code.</p >
587+ be posted to the httpd bug database unless you are sure you
588+ have found a problem in the httpd source code.</p >
589589 </section >
590590</manualpage >
0 commit comments