序(Preface)

這份手冊是 1.0 版阿帕奇服務(wù)器(Apache HTTP server)的文件。這個(gè)
服務(wù)器是阿帕奇計(jì)劃的產(chǎn)品，此計(jì)劃試圖回應(yīng)某些對積極發(fā)展一套可以
免費(fèi)取得之 HTTP 服務(wù)器的關(guān)心。這個(gè)計(jì)劃的目標(biāo)是提供一個(gè)安全的，
有效率的而且可以擴(kuò)充功能的服務(wù)器，此服務(wù)器提供 HTTP 服務(wù)且符合
目前的 HTTP 標(biāo)準(zhǔn)。

這套阿帕奇 httpd 服務(wù)器的設(shè)計(jì)不但與 NCSA httpd 1.3 相容，并且
提供常常有人要求的特色，像是


。作為身分驗(yàn)認(rèn)之用的 DBM 資料庫
。自定的(customised)錯(cuò)誤與問題回應(yīng)方式
。多重的 directoryindex 指令
。不限次數(shù)的 Alias 以及 Redirect 指令
。以內(nèi)容為基礎(chǔ)的(Content-based) 文件協(xié)商(negotiation)
。虛擬服務(wù)器


阿帕奇授權(quán)書


Copyright 1995 The Apache Group. All rights reserved.

假若符合下列條件，無論是否經(jīng)過修改，以原始程序及執(zhí)行程序的形式
散播與使用都是許可的:


1. 散播原始程序碼必須保留上述的版權(quán)告示，這份條件列表以及下列
聲明。

2. 以執(zhí)行程序碼的形式散播必須在隨附散播的文件以及／或是資訊中
重現(xiàn)上述的版權(quán)告示，這份條件列表以及下列聲明。

3. 所有提及或使用這套軟體特色的廣告都必須顯示下列訊息:
`This product includes software developed by the Apache Group
for use in the Apache HTTP server project (http://www.apache.org/).'

4. `Apache Server' 以及 `Apache Group' 這些名稱沒有隨附前述的
的許可不得用來為這套軟體的衍生產(chǎn)品背書或鼓勵(lì)采用。

5. 以任何形式散播都必須保留下列訊息:
`This product includes software developed by the Apache Group
for use in the Apache HTTP server project (http://www.apache.org/).'

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following condictions
are met:

1. Redistribution of source code must retain the above copyright
notice, this list of condictions and the following disclaimer.

2. Redistribution in binary form must reproduce the above copyright
notice, this list of condictions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.

3. All advertising materials mentioning features or use of this
software must display the following acknowledge: `This product
includes software developed by the Apache Group for use in the
Apache HTTP server project (http://www.apache.org/).'

4. The names `Apache Server' and `Apache Group' must not be used to
endorse or prompt products derived from this software without
prior written permission.

5. Redistribution of any form whatsoever must retain the following
acknowledge: `This product includes software developed by the
Apache Group for use in the Apache HTTP server project
(http://www.apache.org/).'



THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARITICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR ITS
CONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDETAL, SPECIAL,
EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
OF LIABILITY, WHERHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHER WISE)ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This software consists of voluntary contributions made by many
individuals on behalf of the Apache Group and was originally
based on public domain software written at the National Center
for Supercomputing Applications, University of Illinois, Urbana-
Champaign. For more information on the apache Group and the Apache
HTTP server project, please see http://www.apache.org/.



第一章

編譯以及安裝阿帕奇


1.1 下載阿帕奇

最新的阿帕奇資訊可以在阿帕奇網(wǎng)站 http://www.apache.org/ 找到。
此處會(huì)列出目前發(fā)行的版本，任何更新的公開測試版，同時(shí)還有映射的
(mirror)網(wǎng)站與匿名文件傳輸(ftp) 站之細(xì)節(jié)。


1.2 編譯阿帕奇

這一版的阿帕奇支援所謂的‘選用性模組’。然而，為了使這些模組能
有效率，此服務(wù)器必須知道哪些模組要編譯進(jìn)去；這需要產(chǎn)生一點(diǎn)短短
的程序碼(`modules.c') 單純地列出它們。

如果你滿意我們的標(biāo)準(zhǔn)模組集，而且打算繼續(xù)讓它保持這樣，那麼你可
以直接編輯我們提供的 Makefile 并且如同你以前作過的一樣編譯它。
如果你想要使用選用性模組，那麼無論如何，你都得執(zhí)行配置指令稿。

這樣做:

1. 編輯 `Configuration' 這個(gè)文件。這里面包含每一種機(jī)器
的 Makefile 設(shè)定，而且在這底下還有個(gè)額外的節(jié)區(qū)列出要
編譯進(jìn)去的模組，以及包含這些模組的文件名稱，你將得:

(a) 選擇適合你機(jī)器的一種編譯器以及編譯選項(xiàng)。
(b) 消掉相對於你想包含進(jìn)去的模組上面的注解（文件底
端列出模組的那些行）或者加上對應(yīng)你自己所撰寫之
自制(custom)模組的一些新行。注意，如果你想要有
DBM 驗(yàn)認(rèn)(auth)的話必須明確地配置進(jìn)去；只要消掉
對應(yīng)的行上面的注解即可。

2. 執(zhí)行 `Configure' 這個(gè)指令shell;

% Configure
Using `Configuration' as config file
%

這會(huì)產(chǎn)生新版的 Makefile 以及 modules.c 文件。如果你
想要維護(hù)多個(gè)配置，那麼你可以這樣，例如

% Configure -file Configuration.ai
Using alternate config file Configuration.ai
%

3. 鍵入 `make'

我們放進(jìn)阿帕奇發(fā)行套件里的模組是我們測試過而且有許多
阿帕奇發(fā)展群成員使用的模組。這些成員或協(xié)力團(tuán)體(third
parties)配合特殊需要或功能而貢獻(xiàn)的一些額外模組可以在
<URL:http://www.apache.org/dist/contrib/modules/> 里
找到。在該網(wǎng)頁上有如何連結(jié)這些模組到阿帕奇核心程序碼
里去的說明。


1.3 安裝阿帕奇

編譯之後，你將會(huì)在 src/ 目錄里獲得一份稱為 `httpd' 的可執(zhí)行文件。
阿帕奇的可執(zhí)行文件發(fā)行套件會(huì)提供這個(gè)文件。

下一個(gè)步驟是為服務(wù)器編輯配置檔。你應(yīng)該會(huì)在稱為 `conf' 的目錄里
發(fā)現(xiàn)三個(gè)配置檔的發(fā)行版本: srm.conf-dist, access.conf-dist 以及
httpd.conf-dist 。把它們復(fù)制成所需的 srm.conf, access.conf 及
httpd.conf 文件。

首先編輯 httpd.conf 。這設(shè)定此服務(wù)器一般的屬性；端口號，執(zhí)行者的
身分等等。接下來編輯 srm.conf 文件；這設(shè)定文件樹的根目錄，指定像是
服務(wù)端剖析的 HTML 或內(nèi)部的影像地圖(imagemap)剖析等等功能。最後
編輯 access.conf 文件，至少作些存取(access)的基本設(shè)定。

最後，調(diào)用httpd 程序，使用 -f 參數(shù)配合 httpd.conf 所在的完整
路徑。像是，最普遍的例子:

/usr/local/etc/apache/src/httpd -f
/usr/local/etc/apache/conf/httpd.conf

現(xiàn)在服務(wù)器應(yīng)該已經(jīng)開始執(zhí)行。

依照預(yù)設(shè) srm.conf 以及 access.conf 這些文件是藉由名稱定位的；
要藉由其它的名稱來指定調(diào)用它們的話，可以在 httpd.conf 里面使用
AccessConfig 以及 ResourceConfig 指令。