序(Preface)

這份手冊是 1.0 版阿帕奇服務器(Apache HTTP server)的文件。這個
服務器是阿帕奇計劃的產品，此計劃試圖回應某些對積極發展一套可以
免費取得之 HTTP 服務器的關心。這個計劃的目標是提供一個安全的，
有效率的而且可以擴充功能的服務器，此服務器提供 HTTP 服務且符合
目前的 HTTP 標準。

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


。作為身分驗認之用的 DBM 資料庫
。自定的(customised)錯誤與問題回應方式
。多重的 directoryindex 指令
。不限次數的 Alias 以及 Redirect 指令
。以內容為基礎的(Content-based) 文件協商(negotiation)
。虛擬服務器


阿帕奇授權書


Copyright 1995 The Apache Group. All rights reserved.

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


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

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

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' 這些名稱沒有隨附前述的
的許可不得用來為這套軟體的衍生產品背書或鼓勵采用。

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 下載阿帕奇

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


1.2 編譯阿帕奇

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

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

這樣做:

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

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

2. 執行 `Configure' 這個指令shell;

% Configure
Using `Configuration' as config file
%

這會產生新版的 Makefile 以及 modules.c 文件。如果你
想要維護多個配置，那麼你可以這樣，例如

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

3. 鍵入 `make'

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


1.3 安裝阿帕奇

編譯之後，你將會在 src/ 目錄里獲得一份稱為 `httpd' 的可執行文件。
阿帕奇的可執行文件發行套件會提供這個文件。

下一個步驟是為服務器編輯配置檔。你應該會在稱為 `conf' 的目錄里
發現三個配置檔的發行版本: srm.conf-dist, access.conf-dist 以及
httpd.conf-dist 。把它們復制成所需的 srm.conf, access.conf 及
httpd.conf 文件。

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

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

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

現在服務器應該已經開始執行。

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