home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 April / PCWorld_2002-04_cd.bin / Komunik / apache / apache_1.3.23-win32-x86-no_src.msi / Data.Cab / F98940_httpd.confdistwin < prev    next >
Text File  |  2002-01-09  |  37KB  |  1,021 lines
  1. #
  2. # Based upon the NCSA server configuration files originally by Rob McCool.
  3. #
  4. # This is the main Apache server configuration file.  It contains the
  5. # configuration directives that give the server its instructions.
  6. # See <URL:http://www.apache.org/docs/> for detailed information about
  7. # the directives.
  8. #
  9. # Do NOT simply read the instructions in here without understanding
  10. # what they do.  They're here only as hints or reminders.  If you are unsure
  11. # consult the online docs. You have been warned.  
  12. #
  13. # After this file is processed, the server will look for and process
  14. # @@ServerRoot@@/conf/srm.conf and then @@ServerRoot@@/conf/access.conf
  15. # unless you have overridden these with ResourceConfig and/or
  16. # AccessConfig directives here.
  17. #
  18. # The configuration directives are grouped into three basic sections:
  19. #  1. Directives that control the operation of the Apache server process as a
  20. #     whole (the 'global environment').
  21. #  2. Directives that define the parameters of the 'main' or 'default' server,
  22. #     which responds to requests that aren't handled by a virtual host.
  23. #     These directives also provide default values for the settings
  24. #     of all virtual hosts.
  25. #  3. Settings for virtual hosts, which allow Web requests to be sent to
  26. #     different IP addresses or hostnames and have them handled by the
  27. #     same Apache server process.
  28. #
  29. # Configuration and logfile names: If the filenames you specify for many
  30. # of the server's control files begin with "/" (or "drive:/" for Win32), the
  31. # server will use that explicit path.  If the filenames do *not* begin
  32. # with "/", the value of ServerRoot is prepended -- so "logs/foo.log"
  33. # with ServerRoot set to "/usr/local/apache" will be interpreted by the
  34. # server as "/usr/local/apache/logs/foo.log".
  35. #
  36. # NOTE: Where filenames are specified, you must use forward slashes
  37. # instead of backslashes (e.g., "c:/apache" instead of "c:\apache").
  38. # If a drive letter is omitted, the drive on which Apache.exe is located
  39. # will be used by default.  It is recommended that you always supply
  40. # an explicit drive letter in absolute paths, however, to avoid
  41. # confusion.
  42. #
  43.  
  44. ### Section 1: Global Environment
  45. #
  46. # The directives in this section affect the overall operation of Apache,
  47. # such as the number of concurrent requests it can handle or where it
  48. # can find its configuration files.
  49. #
  50.  
  51. #
  52. # ServerType is either inetd, or standalone.  Inetd mode is only supported on
  53. # Unix platforms.
  54. #
  55. ServerType standalone
  56.  
  57. #
  58. # ServerRoot: The top of the directory tree under which the server's
  59. # configuration, error, and log files are kept.
  60. #
  61. ServerRoot "@@ServerRoot@@"
  62.  
  63. #
  64. # PidFile: The file in which the server should record its process
  65. # identification number when it starts.
  66. #
  67. PidFile logs/httpd.pid
  68.  
  69. #
  70. # ScoreBoardFile: File used to store internal server process information.
  71. # Not all architectures require this.  But if yours does (you'll know because
  72. # this file will be  created when you run Apache) then you *must* ensure that
  73. # no two invocations of Apache share the same scoreboard file.
  74. #
  75. ScoreBoardFile logs/apache_runtime_status
  76.  
  77. #
  78. # In the standard configuration, the server will process httpd.conf (this 
  79. # file, specified by the -f command line option), srm.conf, and access.conf 
  80. # in that order.  The latter two files are now distributed empty, as it is 
  81. # recommended that all directives be kept in a single file for simplicity.  
  82. # The commented-out values below are the built-in defaults.  You can have the 
  83. # server ignore these files altogether by using "/dev/null" (for Unix) or
  84. # "nul" (for Win32) for the arguments to the directives.
  85. #
  86. #ResourceConfig conf/srm.conf
  87. #AccessConfig conf/access.conf
  88.  
  89. #
  90. # Timeout: The number of seconds before receives and sends time out.
  91. #
  92. Timeout 300
  93.  
  94. #
  95. # KeepAlive: Whether or not to allow persistent connections (more than
  96. # one request per connection). Set to "Off" to deactivate.
  97. #
  98. KeepAlive On
  99.  
  100. #
  101. # MaxKeepAliveRequests: The maximum number of requests to allow
  102. # during a persistent connection. Set to 0 to allow an unlimited amount.
  103. # We recommend you leave this number high, for maximum performance.
  104. #
  105. MaxKeepAliveRequests 100
  106.  
  107. #
  108. # KeepAliveTimeout: Number of seconds to wait for the next request from the
  109. # same client on the same connection.
  110. #
  111. KeepAliveTimeout 15
  112.  
  113. #
  114. # Apache on Win32 always creates one child process to handle requests.  If it
  115. # dies, another child process is created automatically.  Within the child
  116. # process multiple threads handle incoming requests.  The next two
  117. # directives control the behaviour of the threads and processes.
  118. #
  119.  
  120. #
  121. # MaxRequestsPerChild: the number of requests each child process is
  122. # allowed to process before the child dies.  The child will exit so
  123. # as to avoid problems after prolonged use when Apache (and maybe the
  124. # libraries it uses) leak memory or other resources.  On most systems, this
  125. # isn't really needed, but a few (such as Solaris) do have notable leaks
  126. # in the libraries.  For Win32, set this value to zero (unlimited)
  127. # unless advised otherwise.
  128. #
  129. # NOTE: This value does not include keepalive requests after the initial
  130. #       request per connection. For example, if a child process handles
  131. #       an initial request and 10 subsequent "keptalive" requests, it
  132. #       would only count as 1 request towards this limit.
  133. #
  134. MaxRequestsPerChild 0
  135.  
  136. #
  137. # Number of concurrent threads (i.e., requests) the server will allow.
  138. # Set this value according to the responsiveness of the server (more
  139. # requests active at once means they're all handled more slowly) and
  140. # the amount of system resources you'll allow the server to consume.
  141. #
  142. ThreadsPerChild 50
  143.  
  144. #
  145. # Listen: Allows you to bind Apache to specific IP addresses and/or
  146. # ports, in addition to the default. See also the <VirtualHost>
  147. # directive.
  148. #
  149. #Listen 3000
  150. #Listen 12.34.56.78:80
  151.  
  152. #
  153. # BindAddress: You can support virtual hosts with this option. This directive
  154. # is used to tell the server which IP address to listen to. It can either
  155. # contain "*", an IP address, or a fully qualified Internet domain name.
  156. # See also the <VirtualHost> and Listen directives.
  157. #
  158. #BindAddress *
  159.  
  160. #
  161. # Dynamic Shared Object (DSO) Support
  162. #
  163. # To be able to use the functionality of a module which was built as a DSO you
  164. # have to place corresponding `LoadModule' lines at this location so the
  165. # directives contained in it are actually available _before_ they are used.
  166. # Please read the file README.DSO in the Apache 1.3 distribution for more
  167. # details about the DSO mechanism and run `apache -l' for the list of already
  168. # built-in (statically linked and thus always available) modules in your Apache
  169. # binary.
  170. #
  171. # Note: The order in which modules are loaded is important.  Don't change
  172. # the order below without expert advice.
  173. #
  174. # Example:
  175. # LoadModule foo_module modules/mod_foo.so
  176. #
  177. #LoadModule vhost_alias_module modules/mod_vhost_alias.so
  178. #LoadModule mime_magic_module modules/mod_mime_magic.so
  179. #LoadModule status_module modules/mod_status.so
  180. #LoadModule info_module modules/mod_info.so
  181. #LoadModule speling_module modules/mod_speling.so
  182. #LoadModule rewrite_module modules/mod_rewrite.so
  183. #LoadModule anon_auth_module modules/mod_auth_anon.so
  184. #LoadModule dbm_auth_module modules/mod_auth_dbm.so
  185. #LoadModule digest_auth_module modules/mod_auth_digest.so
  186. #LoadModule digest_module modules/mod_digest.so
  187. #LoadModule proxy_module modules/mod_proxy.so
  188. #LoadModule cern_meta_module modules/mod_cern_meta.so
  189. #LoadModule expires_module modules/mod_expires.so
  190. #LoadModule headers_module modules/mod_headers.so
  191. #LoadModule usertrack_module modules/mod_usertrack.so
  192. #LoadModule unique_id_module modules/mod_unique_id.so
  193.  
  194. #
  195. #  Reconstruction of the complete module list from all available modules
  196. #  (static and shared ones) to achieve correct module execution order.
  197. #
  198. # The modules listed below, without a corresponding LoadModule directive,
  199. # are static bound into the standard Apache binary distribution for Windows.
  200. #
  201. # Note: The order in which modules are loaded is important.  Don't change
  202. # the order below without expert advice.
  203. #
  204. # [WHENEVER YOU CHANGE THE LOADMODULE SECTION ABOVE, UPDATE THIS TOO!]
  205. ClearModuleList
  206. #AddModule mod_vhost_alias.c
  207. AddModule mod_env.c
  208. AddModule mod_log_config.c
  209. #AddModule mod_mime_magic.c
  210. AddModule mod_mime.c
  211. AddModule mod_negotiation.c
  212. #AddModule mod_status.c
  213. #AddModule mod_info.c
  214. AddModule mod_include.c
  215. AddModule mod_autoindex.c
  216. AddModule mod_dir.c
  217. AddModule mod_isapi.c
  218. AddModule mod_cgi.c
  219. AddModule mod_asis.c
  220. AddModule mod_imap.c
  221. AddModule mod_actions.c
  222. #AddModule mod_speling.c
  223. AddModule mod_userdir.c
  224. AddModule mod_alias.c
  225. #AddModule mod_rewrite.c
  226. AddModule mod_access.c
  227. AddModule mod_auth.c
  228. #AddModule mod_auth_anon.c
  229. #AddModule mod_auth_dbm.c
  230. #AddModule mod_auth_digest.c
  231. #AddModule mod_digest.c
  232. #AddModule mod_proxy.c
  233. #AddModule mod_cern_meta.c
  234. #AddModule mod_expires.c
  235. #AddModule mod_headers.c
  236. #AddModule mod_usertrack.c
  237. #AddModule mod_unique_id.c
  238. AddModule mod_so.c
  239. AddModule mod_setenvif.c
  240.  
  241.  
  242. #
  243. # ExtendedStatus controls whether Apache will generate "full" status
  244. # information (ExtendedStatus On) or just basic information (ExtendedStatus
  245. # Off) when the "server-status" handler is called. The default is Off.
  246. #
  247. #ExtendedStatus On
  248.  
  249. ### Section 2: 'Main' server configuration
  250. #
  251. # The directives in this section set up the values used by the 'main'
  252. # server, which responds to any requests that aren't handled by a
  253. # <VirtualHost> definition.  These values also provide defaults for
  254. # any <VirtualHost> containers you may define later in the file.
  255. #
  256. # All of these directives may appear inside <VirtualHost> containers,
  257. # in which case these default settings will be overridden for the
  258. # virtual host being defined.
  259. #
  260.  
  261. #
  262. # Port: The port to which the standalone server listens.  Certain firewall
  263. # products must be configured before Apache can listen to a specific port.
  264. # Other running httpd servers will also interfere with this port.  Disable
  265. # all firewall, security, and other services if you encounter problems.
  266. # To help diagnose problems use the Windows NT command NETSTAT -a
  267. #
  268. Port 80
  269.  
  270. #
  271. # ServerAdmin: Your address, where problems with the server should be
  272. # e-mailed.  This address appears on some server-generated pages, such
  273. # as error documents.
  274. #
  275. ServerAdmin @@ServerAdmin@@
  276.  
  277. #
  278. # ServerName allows you to set a host name which is sent back to clients for
  279. # your server if it's different than the one the program would get (i.e., use
  280. # "www" instead of the host's real name).
  281. #
  282. # Note: You cannot just invent host names and hope they work. The name you 
  283. # define here must be a valid DNS name for your host. If you don't understand
  284. # this, ask your network administrator.
  285. # If your host doesn't have a registered DNS name, enter its IP address here.
  286. # You will have to access it by its address (e.g., http://123.45.67.89/)
  287. # anyway, and this will make redirections work in a sensible way.
  288. #
  289. # 127.0.0.1 is the TCP/IP local loop-back address, often named localhost. Your 
  290. # machine always knows itself by this address. If you use Apache strictly for 
  291. # local testing and development, you may use 127.0.0.1 as the server name.
  292. #
  293. ServerName @@ServerName@@
  294.  
  295.  
  296. #
  297. # DocumentRoot: The directory out of which you will serve your
  298. # documents. By default, all requests are taken from this directory, but
  299. # symbolic links and aliases may be used to point to other locations.
  300. #
  301. DocumentRoot "@@ServerRoot@@/htdocs"
  302.  
  303. #
  304. # Each directory to which Apache has access, can be configured with respect
  305. # to which services and features are allowed and/or disabled in that
  306. # directory (and its subdirectories). 
  307. #
  308. # First, we configure the "default" to be a very restrictive set of 
  309. # permissions.  
  310. #
  311. <Directory />
  312.     Options FollowSymLinks
  313.     AllowOverride None
  314. </Directory>
  315.  
  316. #
  317. # Note that from this point forward you must specifically allow
  318. # particular features to be enabled - so if something's not working as
  319. # you might expect, make sure that you have specifically enabled it
  320. # below.
  321. #
  322.  
  323. #
  324. # This should be changed to whatever you set DocumentRoot to.
  325. #
  326. <Directory "@@ServerRoot@@/htdocs">
  327.  
  328. #
  329. # This may also be "None", "All", or any combination of "Indexes",
  330. # "Includes", "FollowSymLinks", "ExecCGI", or "MultiViews".
  331. #
  332. # Note that "MultiViews" must be named *explicitly* --- "Options All"
  333. # doesn't give it to you.
  334. #
  335.     Options Indexes FollowSymLinks MultiViews
  336.  
  337. #
  338. # This controls which options the .htaccess files in directories can
  339. # override. Can also be "All", or any combination of "Options", "FileInfo", 
  340. # "AuthConfig", and "Limit"
  341. #
  342.     AllowOverride None
  343.  
  344. #
  345. # Controls who can get stuff from this server.
  346. #
  347.     Order allow,deny
  348.     Allow from all
  349. </Directory>
  350.  
  351. #
  352. # UserDir: The name of the directory which is appended onto a user's home
  353. # directory if a ~user request is received.
  354. #
  355. # Under Win32, we do not currently try to determine the home directory of
  356. # a Windows login, so a format such as that below needs to be used.  See
  357. # the UserDir documentation for details.
  358. #
  359. <IfModule mod_userdir.c>
  360.     UserDir "@@ServerRoot@@/users/"
  361. </IfModule>
  362.  
  363. #
  364. # Control access to UserDir directories.  The following is an example
  365. # for a site where these directories are restricted to read-only.
  366. #
  367. #<Directory "@@ServerRoot@@/users">
  368. #    AllowOverride FileInfo AuthConfig Limit
  369. #    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
  370. #    <Limit GET POST OPTIONS PROPFIND>
  371. #        Order allow,deny
  372. #        Allow from all
  373. #    </Limit>
  374. #    <LimitExcept GET POST OPTIONS PROPFIND>
  375. #        Order deny,allow
  376. #        Deny from all
  377. #    </LimitExcept>
  378. #</Directory>
  379.  
  380. #
  381. # DirectoryIndex: Name of the file or files to use as a pre-written HTML
  382. # directory index.  Separate multiple entries with spaces.
  383. #
  384. <IfModule mod_dir.c>
  385.     DirectoryIndex index.html
  386. </IfModule>
  387.  
  388. #
  389. # AccessFileName: The name of the file to look for in each directory
  390. # for access control information.
  391. #
  392. AccessFileName .htaccess
  393.  
  394. #
  395. # The following lines prevent .htaccess files from being viewed by
  396. # Web clients.  Since .htaccess files often contain authorization
  397. # information, access is disallowed for security reasons.  Comment
  398. # these lines out if you want Web visitors to see the contents of
  399. # .htaccess files.  If you change the AccessFileName directive above,
  400. # be sure to make the corresponding changes here.
  401. #
  402. # Also, folks tend to use names such as .htpasswd for password
  403. # files, so this will protect those as well.
  404. #
  405. <Files ~ "^\.ht">
  406.     Order allow,deny
  407.     Deny from all
  408.     Satisfy All
  409. </Files>
  410.  
  411. #
  412. # CacheNegotiatedDocs: By default, Apache sends "Pragma: no-cache" with each
  413. # document that was negotiated on the basis of content. This asks proxy
  414. # servers not to cache the document. Uncommenting the following line disables
  415. # this behavior, and proxies will be allowed to cache the documents.
  416. #
  417. #CacheNegotiatedDocs
  418.  
  419. #
  420. # UseCanonicalName:  (new for 1.3)  With this setting turned on, whenever
  421. # Apache needs to construct a self-referencing URL (a URL that refers back
  422. # to the server the response is coming from) it will use ServerName and
  423. # Port to form a "canonical" name.  With this setting off, Apache will
  424. # use the hostname:port that the client supplied, when possible.  This
  425. # also affects SERVER_NAME and SERVER_PORT in CGI scripts.
  426. #
  427. UseCanonicalName On
  428.  
  429. #
  430. # TypesConfig describes where the mime.types file (or equivalent) is
  431. # to be found.
  432. #
  433. <IfModule mod_mime.c>
  434.     TypesConfig conf/mime.types
  435. </IfModule>
  436.  
  437. #
  438. # DefaultType is the default MIME type the server will use for a document
  439. # if it cannot otherwise determine one, such as from filename extensions.
  440. # If your server contains mostly text or HTML documents, "text/plain" is
  441. # a good value.  If most of your content is binary, such as applications
  442. # or images, you may want to use "application/octet-stream" instead to
  443. # keep browsers from trying to display binary files as though they are
  444. # text.
  445. #
  446. DefaultType text/plain
  447.  
  448. #
  449. # The mod_mime_magic module allows the server to use various hints from the
  450. # contents of the file itself to determine its type.  The MIMEMagicFile
  451. # directive tells the module where the hint definitions are located.
  452. # mod_mime_magic is not part of the default server (you have to add
  453. # it yourself with a LoadModule [see the DSO paragraph in the 'Global
  454. # Environment' section], or recompile the server and include mod_mime_magic
  455. # as part of the configuration), so it's enclosed in an <IfModule> container.
  456. # This means that the MIMEMagicFile directive will only be processed if the
  457. # module is part of the server.
  458. #
  459. <IfModule mod_mime_magic.c>
  460.     MIMEMagicFile conf/magic
  461. </IfModule>
  462.  
  463. #
  464. # HostnameLookups: Log the names of clients or just their IP addresses
  465. # e.g., www.apache.org (on) or 204.62.129.132 (off).
  466. # The default is off because it'd be overall better for the net if people
  467. # had to knowingly turn this feature on, since enabling it means that
  468. # each client request will result in AT LEAST one lookup request to the
  469. # nameserver.
  470. #
  471. HostnameLookups Off
  472.  
  473. #
  474. # ErrorLog: The location of the error log file.
  475. # If you do not specify an ErrorLog directive within a <VirtualHost>
  476. # container, error messages relating to that virtual host will be
  477. # logged here.  If you *do* define an error logfile for a <VirtualHost>
  478. # container, that host's errors will be logged there and not here.
  479. #
  480. ErrorLog logs/error.log
  481.  
  482. #
  483. # LogLevel: Control the number of messages logged to the error.log.
  484. # Possible values include: debug, info, notice, warn, error, crit,
  485. # alert, emerg.
  486. #
  487. LogLevel warn
  488.  
  489. #
  490. # The following directives define some format nicknames for use with
  491. # a CustomLog directive (see below).
  492. #
  493. LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
  494. LogFormat "%h %l %u %t \"%r\" %>s %b" common
  495. LogFormat "%{Referer}i -> %U" referer
  496. LogFormat "%{User-agent}i" agent
  497.  
  498. #
  499. # The location and format of the access logfile (Common Logfile Format).
  500. # If you do not define any access logfiles within a <VirtualHost>
  501. # container, they will be logged here.  Contrariwise, if you *do*
  502. # define per-<VirtualHost> access logfiles, transactions will be
  503. # logged therein and *not* in this file.
  504. #
  505. CustomLog logs/access.log common
  506.  
  507. #
  508. # If you would like to have agent and referer logfiles, uncomment the
  509. # following directives.
  510. #
  511. #CustomLog logs/referer.log referer
  512. #CustomLog logs/agent.log agent
  513.  
  514. #
  515. # If you prefer a single logfile with access, agent, and referer information
  516. # (Combined Logfile Format) you can use the following directive.
  517. #
  518. #CustomLog logs/access.log combined
  519.  
  520. #
  521. # Optionally add a line containing the server version and virtual host
  522. # name to server-generated pages (error documents, FTP directory listings,
  523. # mod_status and mod_info output etc., but not CGI generated documents).
  524. # Set to "EMail" to also include a mailto: link to the ServerAdmin.
  525. # Set to one of:  On | Off | EMail
  526. #
  527. ServerSignature On
  528.  
  529. # 
  530. # Apache parses all CGI scripts for the shebang line by default.
  531. # This comment line, the first line of the script, consists of the symbols
  532. # pound (#) and exclamation (!) followed by the path of the program that 
  533. # can execute this specific script.  For a perl script, with perl.exe in
  534. # the C:\Program Files\Perl directory, the shebang line should be:
  535.  
  536.    #!c:/program files/perl/perl
  537.  
  538. # Note you _must_not_ indent the actual shebang line, and it must be the
  539. # first line of the file.  Of course, CGI processing must be enabled by 
  540. # the appropriate ScriptAlias or Options ExecCGI directives for the files 
  541. # or directory in question.
  542. #
  543. # However, Apache on Windows allows either the Unix behavior above, or can
  544. # use the Registry to match files by extention.  The command to execute 
  545. # a file of this type is retrieved from the registry by the same method as 
  546. # the Windows Explorer would use to handle double-clicking on a file.
  547. # These script actions can be configured from the Windows Explorer View menu, 
  548. # 'Folder Options', and reviewing the 'File Types' tab.  Clicking the Edit
  549. # button allows you to modify the Actions, of which Apache 1.3 attempts to
  550. # perform the 'Open' Action, and failing that it will try the shebang line.
  551. # This behavior is subject to change in Apache release 2.0.
  552. #
  553. # Each mechanism has it's own specific security weaknesses, from the means
  554. # to run a program you didn't intend the website owner to invoke, and the
  555. # best method is a matter of great debate.
  556. #
  557. # To enable the this Windows specific behavior (and therefore -disable- the
  558. # equivilant Unix behavior), uncomment the following directive:
  559. #
  560. #ScriptInterpreterSource registry
  561. #
  562. # The directive above can be placed in individual <Directory> blocks or the
  563. # .htaccess file, with either the 'registry' (Windows behavior) or 'script' 
  564. # (Unix behavior) option, and will override this server default option.
  565. #
  566.  
  567. #
  568. # Aliases: Add here as many aliases as you need (with no limit). The format is 
  569. # Alias fakename realname
  570. #
  571. <IfModule mod_alias.c>
  572.  
  573.     #
  574.     # Note that if you include a trailing / on fakename then the server will
  575.     # require it to be present in the URL.  So "/icons" isn't aliased in this
  576.     # example, only "/icons/".  If the fakename is slash-terminated, then the 
  577.     # realname must also be slash terminated, and if the fakename omits the 
  578.     # trailing slash, the realname must also omit it.
  579.     #
  580.     Alias /icons/ "@@ServerRoot@@/icons/"
  581.  
  582.     <Directory "@@ServerRoot@@/icons">
  583.         Options Indexes MultiViews
  584.         AllowOverride None
  585.         Order allow,deny
  586.         Allow from all
  587.     </Directory>
  588.  
  589.     # This Alias will project the on-line documentation tree under /manual/
  590.     # even if you change the DocumentRoot. Comment it if you don't want to 
  591.     # provide access to the on-line documentation.
  592.     #
  593.     Alias /manual/ "@@ServerRoot@@/htdocs/manual/"
  594.  
  595.     <Directory "@@ServerRoot@@/htdocs/manual">
  596.         Options Indexes FollowSymlinks MultiViews
  597.         AllowOverride None
  598.         Order allow,deny
  599.         Allow from all
  600.     </Directory>
  601.  
  602.     #
  603.     # ScriptAlias: This controls which directories contain server scripts.
  604.     # ScriptAliases are essentially the same as Aliases, except that
  605.     # documents in the realname directory are treated as applications and
  606.     # run by the server when requested rather than as documents sent to the client.
  607.     # The same rules about trailing "/" apply to ScriptAlias directives as to
  608.     # Alias.
  609.     #
  610.     ScriptAlias /cgi-bin/ "@@ServerRoot@@/cgi-bin/"
  611.  
  612.     #
  613.     # "@@ServerRoot@@/cgi-bin" should be changed to whatever your ScriptAliased
  614.     # CGI directory exists, if you have that configured.
  615.     #
  616.     <Directory "@@ServerRoot@@/cgi-bin">
  617.         AllowOverride None
  618.         Options None
  619.         Order allow,deny
  620.         Allow from all
  621.     </Directory>
  622.  
  623. </IfModule>
  624. # End of aliases.
  625.  
  626. #
  627. # Redirect allows you to tell clients about documents which used to exist in
  628. # your server's namespace, but do not anymore. This allows you to tell the
  629. # clients where to look for the relocated document.
  630. # Format: Redirect old-URI new-URL
  631. #
  632.  
  633. #
  634. # Directives controlling the display of server-generated directory listings.
  635. #
  636. <IfModule mod_autoindex.c>
  637.  
  638.     #
  639.     # FancyIndexing is whether you want fancy directory indexing or standard
  640.     #
  641.     # Note, add the option TrackModified to the IndexOptions default list only
  642.     # if all indexed directories reside on NTFS volumes.  The TrackModified flag
  643.     # will report the Last-Modified date to assist caches and proxies to properly
  644.     # track directory changes, but it does _not_ work on FAT volumes.
  645.     #
  646.     IndexOptions FancyIndexing
  647.  
  648.     #
  649.     # AddIcon* directives tell the server which icon to show for different
  650.     # files or filename extensions.  These are only displayed for
  651.     # FancyIndexed directories.
  652.     #
  653.     AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
  654.  
  655.     AddIconByType (TXT,/icons/text.gif) text/*
  656.     AddIconByType (IMG,/icons/image2.gif) image/*
  657.     AddIconByType (SND,/icons/sound2.gif) audio/*
  658.     AddIconByType (VID,/icons/movie.gif) video/*
  659.  
  660.     AddIcon /icons/binary.gif .bin .exe
  661.     AddIcon /icons/binhex.gif .hqx
  662.     AddIcon /icons/tar.gif .tar
  663.     AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
  664.     AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
  665.     AddIcon /icons/a.gif .ps .ai .eps
  666.     AddIcon /icons/layout.gif .html .shtml .htm .pdf
  667.     AddIcon /icons/text.gif .txt
  668.     AddIcon /icons/c.gif .c
  669.     AddIcon /icons/p.gif .pl .py
  670.     AddIcon /icons/f.gif .for
  671.     AddIcon /icons/dvi.gif .dvi
  672.     AddIcon /icons/uuencoded.gif .uu
  673.     AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
  674.     AddIcon /icons/tex.gif .tex
  675.     AddIcon /icons/bomb.gif core
  676.  
  677.     AddIcon /icons/back.gif ..
  678.     AddIcon /icons/hand.right.gif README
  679.     AddIcon /icons/folder.gif ^^DIRECTORY^^
  680.     AddIcon /icons/blank.gif ^^BLANKICON^^
  681.  
  682.     #
  683.     # DefaultIcon is which icon to show for files which do not have an icon
  684.     # explicitly set.
  685.     #
  686.     DefaultIcon /icons/unknown.gif
  687.  
  688.     #
  689.     # AddDescription allows you to place a short description after a file in
  690.     # server-generated indexes.  These are only displayed for FancyIndexed
  691.     # directories.
  692.     # Format: AddDescription "description" filename
  693.     #
  694.     #AddDescription "GZIP compressed document" .gz
  695.     #AddDescription "tar archive" .tar
  696.     #AddDescription "GZIP compressed tar archive" .tgz
  697.  
  698.     #
  699.     # ReadmeName is the name of the README file the server will look for by
  700.     # default, and append to directory listings.
  701.     #
  702.     # HeaderName is the name of a file which should be prepended to
  703.     # directory indexes. 
  704.     #
  705.     # If MultiViews are amongst the Options in effect, the server will
  706.     # first look for name.html and include it if found.  If name.html
  707.     # doesn't exist, the server will then look for name.txt and include
  708.     # it as plaintext if found.
  709.     #
  710.     ReadmeName README
  711.     HeaderName HEADER
  712.  
  713.     #
  714.     # IndexIgnore is a set of filenames which directory indexing should ignore
  715.     # and not include in the listing.  Shell-style wildcarding is permitted.
  716.     #
  717.     IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
  718.  
  719. </IfModule>
  720. # End of indexing directives.
  721.  
  722. #
  723. # Document types.
  724. #
  725. <IfModule mod_mime.c>
  726.  
  727.     #
  728.     # AddEncoding allows you to have certain browsers (Mosaic/X 2.1+) uncompress
  729.     # information on the fly. Note: Not all browsers support this.
  730.     # Despite the name similarity, the following Add* directives have nothing
  731.     # to do with the FancyIndexing customization directives above.
  732.     #
  733.     AddEncoding x-compress Z
  734.     AddEncoding x-gzip gz tgz
  735.     #
  736.     # AddLanguage allows you to specify the language of a document. You can
  737.     # then use content negotiation to give a browser a file in a language
  738.     # it can understand.
  739.     #
  740.     # Note 1: The suffix does not have to be the same as the language
  741.     # keyword --- those with documents in Polish (whose net-standard
  742.     # language code is pl) may wish to use "AddLanguage pl .po" to
  743.     # avoid the ambiguity with the common suffix for perl scripts.
  744.     #
  745.     # Note 2: The example entries below illustrate that in quite
  746.     # some cases the two character 'Language' abbreviation is not
  747.     # identical to the two character 'Country' code for its country,
  748.     # E.g. 'Danmark/dk' versus 'Danish/da'.
  749.     #
  750.     # Note 3: In the case of 'ltz' we violate the RFC by using a three char
  751.     # specifier. But there is 'work in progress' to fix this and get
  752.     # the reference data for rfc1766 cleaned up.
  753.     #
  754.     # Danish (da) - Dutch (nl) - English (en) - Estonian (ee)
  755.     # French (fr) - German (de) - Greek-Modern (el)
  756.     # Italian (it) - Korean (kr) - Norwegian (no) - Norwegian Nynorsk (nn)
  757.     # Portugese (pt) - Luxembourgeois* (ltz)
  758.     # Spanish (es) - Swedish (sv) - Catalan (ca) - Czech(cz)
  759.     # Polish (pl) - Brazilian Portuguese (pt-br) - Japanese (ja)
  760.     # Russian (ru)
  761.     #
  762.     AddLanguage da .dk
  763.     AddLanguage nl .nl
  764.     AddLanguage en .en
  765.     AddLanguage et .ee
  766.     AddLanguage fr .fr
  767.     AddLanguage de .de
  768.     AddLanguage el .el
  769.     AddLanguage he .he
  770.     AddCharset ISO-8859-8 .iso8859-8
  771.     AddLanguage it .it
  772.     AddLanguage ja .ja
  773.     AddCharset ISO-2022-JP .jis
  774.     AddLanguage kr .kr
  775.     AddCharset ISO-2022-KR .iso-kr
  776.     AddLanguage nn .nn
  777.     AddLanguage no .no
  778.     AddLanguage pl .po
  779.     AddCharset ISO-8859-2 .iso-pl
  780.     AddLanguage pt .pt
  781.     AddLanguage pt-br .pt-br
  782.     AddLanguage ltz .lu
  783.     AddLanguage ca .ca
  784.     AddLanguage es .es
  785.     AddLanguage sv .se
  786.     AddLanguage cz .cz
  787.     AddLanguage ru .ru
  788.     AddLanguage tw .tw
  789.     AddLanguage zh-tw .tw
  790.     AddCharset Big5         .Big5    .big5
  791.     AddCharset WINDOWS-1251 .cp-1251
  792.     AddCharset CP866        .cp866
  793.     AddCharset ISO-8859-5   .iso-ru
  794.     AddCharset KOI8-R       .koi8-r
  795.     AddCharset UCS-2        .ucs2
  796.     AddCharset UCS-4        .ucs4
  797.     AddCharset UTF-8        .utf8
  798.  
  799.     # LanguagePriority allows you to give precedence to some languages
  800.     # in case of a tie during content negotiation.
  801.     #
  802.     # Just list the languages in decreasing order of preference. We have
  803.     # more or less alphabetized them here. You probably want to change this.
  804.     #
  805.     <IfModule mod_negotiation.c>
  806.         LanguagePriority en da nl et fr de el it ja kr no pl pt pt-br ru ltz ca es sv tw
  807.     </IfModule>
  808.  
  809.     #
  810.     # AddType allows you to tweak mime.types without actually editing it, or to
  811.     # make certain files to be certain types.
  812.     #
  813.     AddType application/x-tar .tgz
  814.  
  815.     #
  816.     # AddHandler allows you to map certain file extensions to "handlers",
  817.     # actions unrelated to filetype. These can be either built into the server
  818.     # or added with the Action command (see below)
  819.     #
  820.     # If you want to use server side includes, or CGI outside
  821.     # ScriptAliased directories, uncomment the following lines.
  822.     #
  823.     # To use CGI scripts:
  824.     #
  825.     #AddHandler cgi-script .cgi
  826.  
  827.     #
  828.     # To use server-parsed HTML files
  829.     #
  830.     #AddType text/html .shtml
  831.     #AddHandler server-parsed .shtml
  832.  
  833.     #
  834.     # Uncomment the following line to enable Apache's send-asis HTTP file
  835.     # feature
  836.     #
  837.     #AddHandler send-as-is asis
  838.  
  839.     #
  840.     # If you wish to use server-parsed imagemap files, use
  841.     #
  842.     #AddHandler imap-file map
  843.  
  844.     #
  845.     # To enable type maps, you might want to use
  846.     #
  847.     #AddHandler type-map var
  848.  
  849. </IfModule>
  850. # End of document types.
  851.  
  852. #
  853. # Action lets you define media types that will execute a script whenever
  854. # a matching file is called. This eliminates the need for repeated URL
  855. # pathnames for oft-used CGI file processors.
  856. # Format: Action media/type /cgi-script/location
  857. # Format: Action handler-name /cgi-script/location
  858. #
  859.  
  860. #
  861. # MetaDir: specifies the name of the directory in which Apache can find
  862. # meta information files. These files contain additional HTTP headers
  863. # to include when sending the document
  864. #
  865. #MetaDir .web
  866.  
  867. #
  868. # MetaSuffix: specifies the file name suffix for the file containing the
  869. # meta information.
  870. #
  871. #MetaSuffix .meta
  872.  
  873. #
  874. # Customizable error response (Apache style)
  875. #  these come in three flavors
  876. #
  877. #    1) plain text
  878. #ErrorDocument 500 "The server made a boo boo.
  879. #  n.b.  the single leading (") marks it as text, it does not get output
  880. #
  881. #    2) local redirects
  882. #ErrorDocument 404 /missing.html
  883. #  to redirect to local URL /missing.html
  884. #ErrorDocument 404 /cgi-bin/missing_handler.pl
  885. #  N.B.: You can redirect to a script or a document using server-side-includes.
  886. #
  887. #    3) external redirects
  888. #ErrorDocument 402 http://some.other-server.com/subscription_info.html
  889. #  N.B.: Many of the environment variables associated with the original
  890. #  request will *not* be available to such a script.
  891.  
  892. #
  893. # Customize behaviour based on the browser
  894. #
  895. <IfModule mod_setenvif.c>
  896.  
  897.     #
  898.     # The following directives modify normal HTTP response behavior.
  899.     # The first directive disables keepalive for Netscape 2.x and browsers that
  900.     # spoof it. There are known problems with these browser implementations.
  901.     # The second directive is for Microsoft Internet Explorer 4.0b2
  902.     # which has a broken HTTP/1.1 implementation and does not properly
  903.     # support keepalive when it is used on 301 or 302 (redirect) responses.
  904.     #
  905.     BrowserMatch "Mozilla/2" nokeepalive
  906.     BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
  907.  
  908.     #
  909.     # The following directive disables HTTP/1.1 responses to browsers which
  910.     # are in violation of the HTTP/1.0 spec by not being able to grok a
  911.     # basic 1.1 response.
  912.     #
  913.     BrowserMatch "RealPlayer 4\.0" force-response-1.0
  914.     BrowserMatch "Java/1\.0" force-response-1.0
  915.     BrowserMatch "JDK/1\.0" force-response-1.0
  916.  
  917. </IfModule>
  918. # End of browser customization directives
  919.  
  920. #
  921. # Allow server status reports, with the URL of http://servername/server-status
  922. # Change the "@@Domain@@" to match your domain to enable.
  923. #
  924. #<Location /server-status>
  925. #    SetHandler server-status
  926. #    Order deny,allow
  927. #    Deny from all
  928. #    Allow from @@Domain@@
  929. #</Location>
  930.  
  931. #
  932. # Allow remote server configuration reports, with the URL of
  933. # http://servername/server-info (requires that mod_info.c be loaded).
  934. # Change the "@@Domain@@" to match your domain to enable.
  935. #
  936. #<Location /server-info>
  937. #    SetHandler server-info
  938. #    Order deny,allow
  939. #    Deny from all
  940. #    Allow from @@Domain@@
  941. #</Location>
  942.  
  943. #
  944. # There have been reports of people trying to abuse an old bug from pre-1.1
  945. # days.  This bug involved a CGI script distributed as a part of Apache.
  946. # By uncommenting these lines you can redirect these attacks to a logging 
  947. # script on phf.apache.org.  Or, you can record them yourself, using the script
  948. # support/phf_abuse_log.cgi.
  949. #
  950. #<Location /cgi-bin/phf*>
  951. #    Deny from all
  952. #    ErrorDocument 403 http://phf.apache.org/phf_abuse_log.cgi
  953. #</Location>
  954.  
  955. #
  956. # Proxy Server directives. Uncomment the following lines to
  957. # enable the proxy server:
  958. #
  959. #<IfModule mod_proxy.c>
  960. #    ProxyRequests On
  961.  
  962. #    <Directory proxy:*>
  963. #        Order deny,allow
  964. #        Deny from all
  965. #        Allow from @@Domain@@
  966. #    </Directory>
  967.  
  968.     #
  969.     # Enable/disable the handling of HTTP/1.1 "Via:" headers.
  970.     # ("Full" adds the server version; "Block" removes all outgoing Via: headers)
  971.     # Set to one of: Off | On | Full | Block
  972.     #
  973. #    ProxyVia On
  974.  
  975.     #
  976.     # To enable the cache as well, edit and uncomment the following lines:
  977.     # (no cacheing without CacheRoot)
  978.     #
  979. #    CacheRoot "@@ServerRoot@@/proxy"
  980. #    CacheSize 5
  981. #    CacheGcInterval 4
  982. #    CacheMaxExpire 24
  983. #    CacheLastModifiedFactor 0.1
  984. #    CacheDefaultExpire 1
  985. #    NoCache a-domain.com another-domain.edu joes.garage-sale.com
  986.  
  987. #</IfModule>
  988. # End of proxy directives.
  989.  
  990. ### Section 3: Virtual Hosts
  991. #
  992. # VirtualHost: If you want to maintain multiple domains/hostnames on your
  993. # machine you can setup VirtualHost containers for them. Most configurations
  994. # use only name-based virtual hosts so the server doesn't need to worry about
  995. # IP addresses. This is indicated by the asterisks in the directives below.
  996. #
  997. # Please see the documentation at <URL:http://www.apache.org/docs/vhosts/>
  998. # for further details before you try to setup virtual hosts.
  999. #
  1000. # You may use the command line option '-S' to verify your virtual host
  1001. # configuration.
  1002.  
  1003. #
  1004. # Use name-based virtual hosting.
  1005. #
  1006. #NameVirtualHost *
  1007.  
  1008. #
  1009. # VirtualHost example:
  1010. # Almost any Apache directive may go into a VirtualHost container.
  1011. # The first VirtualHost section is used for requests without a known
  1012. # server name.
  1013. #
  1014. #<VirtualHost *>
  1015. #    ServerAdmin webmaster@dummy-host.example.com
  1016. #    DocumentRoot /www/docs/dummy-host.example.com
  1017. #    ServerName dummy-host.example.com
  1018. #    ErrorLog logs/dummy-host.example.com-error_log
  1019. #    CustomLog logs/dummy-host.example.com-access_log common
  1020. #</VirtualHost>
  1021.