Windows下Apache相关安装指南
2006-08-31 02:09
版权声明：可以任意转载，但转载时必须标明原作者charlee、原始链接http://tech.idv2.com/2006/08/31/apache-install-note/以及本声明。
本文介绍了在Windows下安装Apache、PHP、mod_perl、mod_python、subversion的方法。 <!---->
所需安装文件
- Apache 2.0.59：下载 Apache HTTP Server 2.0.59 Win32 Binary (MSI Installer)
- php 5.1.6：下载 Windows Binaries - php 5.1.6 zip package
- ActivePerl 5.8.8：下载 ActivePerl 5.8.8.817 Windows MSI
- mod_perl 2.0.2：通过 ppm 安装，无须事先下载
- Python 2.3.5：下载Python 2.3.5
- mod_python：下载mod_python 3.2.10，注意要下载 mod_python-3.2.10.win32-py2.3-apache2.0.exe 文件。
- subversion：下载 subversion 1.3.2，建议下载 zip 版 svn-win32-1.3.2.zip。
另外，为了在安装失败时查找原因，最好事先准备好 Dependency Walker 这个工具。该工具可以查看程序运行所必需的 .dll 文件。如果你已经安装了 Microsoft Visual C++ 6.0，那么其中已经包含了该工具，就不必再重新下载了。
安装 Apache 2.0.59
双击 apache_2.0.59-win32-x86-no_ssl.msi 文件开始安装。安装过程很简单，一路Next即可。途中要求输入服务器的域名、服务器名及管理员信箱，输入相应的正确信息。如果仅仅是安装在本地用于测试，则可按照下图所示输入。
安装成功之后打开浏览器，在地址栏中输入 http://localhost/。如果你能看到 Apache 的欢迎页面以及 Apache 的红羽毛的图标，则说明安装成功。否则请参考下面的说明查找失败原因。
安装后的说明
默认安装路径为 C:\Program Files\Apache Group\Apache2。安装程序会建立一个名为 Apache2 的系统服务并自动启动它，可以通过右键单击我的电脑->管理->服务确认其存在，如下图。
另外，安装结束后系统托盘中会多出一个 Apache 的控制图标（如下图），可以通过它来控制 Apache 的启动与停止。如果你想通过系统服务来控制 Apache 的话，可以从开始菜单->程序->启动中删除Monitor Apache Servers 项，下次启动计算机时就不会启动该图标。
Apache的安装目录结构如下图：
其中各个目录的含义如下。
- bin - Apache的程序文件和库文件(.dll)。
- cgi-bin - 网站的脚本的保存位置。
- conf - 配置文件。
- error - 各种错误页面。
- htdocs - 网站的内容。
- icons - Apache生成文件列表时使用的各种图标。
- include - 程序开发时使用的头文件。
- lib - 程序开发时使用的静态库文件。
- logs - 服务器访问日志和错误日志。
- manual - 使用手册。
- modules - 扩展模块，其下有许多扩展名为 .so 的文件，实质上都是Windows .dll文件。
- proxy - 使用Apache作代理时的缓存目录。
修改默认配置
默认情况下网站内容位于 Apache2/htdocs 下，而实际应用中很少讲网站内容和服务器程序放在一起。因此我们要做的第一步就是修改网站内容的位置。
我们假设网站的静态内容位于 D:\wwwroot\htdocs 下，而脚本程序位于 D:\wwwroot\cgi-bin 下。那么首先要建立这两个目录。
之后打开 httpd.conf 文件，找到这一行：
DocumentRoot "C:/Program Files/Apache Group/Apache2/htdocs"
将其修改成：
DocumentRoot "D:/wwwroot/htdocs"
然后找到这样的内容（各行之间可能夹杂着注释）：
<Directory "C:/Program Files/Apache Group/Apache2/htdocs">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
这一段是定义网站主目录的权限。我们应当修改主目录的位置。另外，Indexes 权限表示当某个目录下不存在 index.html 文件时，显示该目录的文件列表。实际应用中这会造成安全漏洞，应当将其删除。修改之后的内容如下：
<Directory "D:/wwwroot/htdocs">
Options FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
然后找到这一行：
ScriptAlias /cgi-bin/ "C:/Program Files/Apache Group/Apache2/cgi-bin/"
将其修改为：
ScriptAlias /cgi-bin/ "D:/wwwroot/cgi-bin/"
再找到这样的内容：
<Directory "C:/Program Files/Apache Group/Apache2/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
将其修改为：
<Directory "D:/wwwroot/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
这样配置文件修改完毕。在系统服务中选择 Apache2 服务单击“重新启动服务”按钮，或者在系统托盘的Apache图标中选择Restart，或者通过命令行输入以下命令来重新启动 Apache。
C:\> net stop apache2 C:\> net start apache2
如果配置文件修改无误，则应当正常重新启动。之后打开浏览器输入 http://localhost/，你应当看到一条“Forbidden”的错误信息。然后建立 D:\wwwroot\htdocs\index.html 文件，内容随意。再次用浏览器打开 http://localhost/，应当能看到建立的 index.html 文件的内容。
为了以后安装其他模块，我们应当修改系统变量 PATH 以便其他模块能够找到 Apache 的程序库。在控制面板->系统->高级->环境变量对话框中，编辑系统变量中的 Path，在其最前面添加以下内容：
C:\Program Files\Apache Group\Apache2\bin;
修改之后，继续安装下面的模块之前，建议重新启动计算机以避免不必要的错误。
常见错误及修正方法
为什么不使用最新版的 Apache 2.2.3
Apache 2.0.x 版本的 Windows 版使用 Visual C++ 6.0 编译，而 Apache 2.2.x 版本的 Windows版使用 Visual Studio .NET 编译。由于编译器不同，导致使用的程序库也不同，因此 Apache 2.0.x 和 Apache 2.2.x 不能兼容。目前，许多 Apache 的功能扩展模块仅能工作于 Apache 2.0.x 下，包括 php、subversion 等。要想使用这些功能，就必须要安装 Apache 2.0.x 版。
当然，这仅限于 Windows 版。其他操作系统上的 Apache 不受此限。
安装 php 5.1.6
php的安装相对较简单。为了管理方便，我们将 php 与 Apache 放在一起。
首先将 php-5.1.6-Win32.zip 解压到 C:\Program Files\Apache Group\Apache2\php5 目录下。
php5中的 Apache2 模块为 php5apache2.dll（注意不是 php5apache.dll，那个是 Apache 1.3.x 的模块）。修改 Apache2/conf 目录下的 httpd.conf 以加载 php5 模块。查找 LoadModule，然后在其附近添加以下内容以加载php5模块，并设置 php.ini 的位置。
LoadModule php5_module php5/php5apache2.dll PHPIniDir php5
然后查找AddType，在其附近添加以下内容，以增加 php 的类型。
AddType application/x-httpd-php .php
再查找DirectoryIndex命令，将其修改为以下内容，增加目录的默认文档 index.php。
DirectoryIndex index.html index.html.var index.htm index.php
然后进入 php5 目录，复制 php.ini-dist 文件为 php.ini。然后修改 php.ini，查找 extension_dir，该变量指定了 php 功能模块的位置。将其修改为以下的内容。
extension_dir = "./php5/ext"
注意，这个路径是从 Apache2 下开始算起，而不是从 Apache2/php5 下开始。
查找 session.save_path，这个变量指定session的保存位置。将其前面的分号去掉，然后修改该行为以下内容：
session.save_path = "C:\Program Files\Apache Group\Apache2\tmp"
然后在 Apache2 目录下建立 tmp 目录，作为session的保存目录。
最后重新启动 Apache 服务器（方法参考 Apache 安装一节）。为测试 php 是否安装成功，在文档目录 D:\wwwroot\htdocs 下建立 phpinfo.php 文件，内容如下：
<?php phpinfo(); ?>
然后打开浏览器，访问 http://localhost/phpinfo.php 。如果能看到 php 的信息页，即表明php安装成功。
PHP各个目录的作用
- dev - 开发用 php 静态库。
- ext - php扩展模块。
- extras - 相关文件。
- PEAR - 访问php模块网站 PEAR 的必要文件。
另外，php目录下的部分文件功能如下。
- php.exe - php的命令行解释程序，也可用作 CGI 解释器。
- php5apache2.dll - Apache 2.0的PHP模块。
- php5apache.dll - Apache 1.3的PHP模块。
- php5isapi.dll - Microsoft IIS的PHP模块。
- php5nsapi.dll - Netscape Server的PHP模块。
- php5ts.dll - PHP及其扩展模所需的库文件。
添加 mysql 支持
php4之前的版本自带mysql，而在php5中，mysql不再默认支持。为了使php5支持mysql，我们需要稍稍修改一下设置。
打开 php5/php.ini 文件，查找下面这一行，并将其前面的注释符号分号 ; 去掉。
extension=php_mysql.dll
但是这样还不能使用mysql功能，因为 php_mysql.dll 需要 php5 目录下的 php5ts.dll 和 libmysql.dll （可以使用 Dependency Walker 打开 php_mysql.dll 查看），但是这两个 DLL 文件既不与 php_mysql.dll 位于同一目录下，也没有和可执行文件Apache.exe 位于同一目录下，因此 php_mysql.dll 找不到这两个DLL，不能启动。解决方法就是将 php5ts.dll 和 libmysql.dll 复制到 Apache2/bin 下，然后重新启动 Apache2。
使用浏览器打开前面的 phpinfo.php 页面，可以看到页面输出的中部有 mysql 模块的配置，说明 mysql 模块已经正常安装。
安装 ActivePerl 5.8.8
ActivePerl是Perl的一个Win32移植版。安装方法很简单，运行 ActivePerl-5.8.8.817-MSWin32-x86-257965.msi ，即出现安装界面，一路 Next 即可。默认情况下安装到 C:\Perl 下。注意在选择功能时务必选择 PPM 3.0，该程序能够很方便地安装各种Perl模块。
下一步需要在系统环境变量中增加 Perl 所在的位置。如果你在安装Perl时选择了 Add Perl to the PATH enviroment variable，则可以省略这一步。否则打开控制面板->系统->高级->环境变量，修改系统变量中的 Path，在其最前面增加以下内容：
C:\Perl\bin;
修改环境变量后，在安装 mod_perl 之前，最好能重新启动计算机。
安装 mod_perl 2.0.2
mod_perl是Apache的Perl扩展模块。它模拟了一个Perl的CGI执行环境，以便在Apache中执行Perl脚本。但是mod_perl要比真正的Perl CGI的性能高上百倍。
Apache 2.0.x 系列对应的 mod_perl 第二版，mod_perl目前最新版本是 2.0.2。可以使用Perl包管理工具 ppm 进行安装。
首先启动命令行提示符（开始->运行->输入cmd，OK），然后输入 ppm，即可启动 ppm。如果启动失败，看看是否在安装 ActivePerl 的时候忘记添加 Path 环境变量了。下面以 ppm> 开头的行为输入的命令，其他行为输出结果。 # 符号后面为注释。
# 添加repository。repository为存放Perl模块的网站。 ppm> repos add "uwinnipeg Perl 5.8 repository" http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 Repositories: [1] ActiveState Package Repository [2] uwinnipeg Perl 5.8 repository # 搜索 mod_perl 模块 ppm> search mod_perl Searching in Active Repositories 1. Apache-mod_perl_guide [1.31] Apache-mod_perl_guide 2. mod_perl [2.0.2] Embed a Perl interpreter in the Apache/2.0 HTTP server 3. mod_perl-1 [1.29_01-dev] Embed a Perl interpreter in the Apache/1.3.27 HTTP server 4. mod_perl-2.2 [2.0.3-dev] Embed a Perl interpreter in the Apache/2.2 HTTP server 5. mod_perl-eapi-1 [1.29_01-dev] Embed a Perl interpreter in the Apache/1.3.27 HTTP server (with EAPI support) # 搜索结果中第2项为我们要安装的 mod_perl 2.0.2，使用install命令进行安装 ppm> install 2 Package 2: ==================== Install 'mod_perl' version 2.0.2 in ActivePerl 5.8.8.817. ==================== Downloaded 948125 bytes. ...... # 安装途中会询问 Apache 的模块安装位置，输入 C:\Program Files\Apache Group\Apache2\modules Fetching http://theoryx5.uwinnipeg.ca/ppms/x86/mod_perl.so ... done! Where should mod_perl.so be placed? [D:/Apache2/modules] C:\Program Files\Apache Group\Apache2\modules # 输入路径 ...... Successfully installed mod_perl version 2.0.2 in ActivePerl 5.8.8.817.
# 退出 ppm ppm> exit
安装完毕之后，我们可以在 Apache2/modules 目录下发现刚刚安装的 mod_perl.so 文件。下面我们要将此文件加载到 Apache 中。
打开 Apache2/conf 目录下的 httpd.conf文件，查找 LoadModule，在其附近添加以下内容：
#LoadFile "C:/Perl/bin/perl58.dll" # 如果你没有在环境变量path中添加 C:\Perl\bin 则需要这一行
LoadModule perl_module modules/mod_perl.so
# 添加mod_perl配置内容，并利用其处理 cgi-bin 下的脚本文件
<Directory "D:/wwwroot/cgi-bin">
SetHandler perl-script
PerlResponseHandler ModPerl::Registry
PerlOptions +ParseHeaders
Options +ExecCGI
AllowOverride None
Order allow,deny
Allow from all
</Directory>
修改完成之后重新启动 Apache，mod_perl 即安装成功。你可以在系统服务中看到 Apache2 服务的描述中多了 mod_perl/2.0.2 Perl/v5.8.8 的字样。
测试CGI脚本的执行
上面我们已经设置 cgi-bin 目录下的所有程序都使用 mod_perl 进行处理。这里我们执行一个脚本以确认其是否正常。
在 D:/wwwroot/cgi-bin 目录下建立 hello.cgi 文件，内容如下。 (实际上，该文件可以是任意扩展名，我们在Apache配置中用 Directory 指令指定 cgi-bin 目录，因此 cgi-bin 下所有的文件都将被 mod_perl 处理。)
# hello.cgi print "Contennt-Type: text/html\n\n"; print "Hello, world! This is a CGI.";
保存之后在浏览器中输入 http://localhost/cgi-bin/hello.cgi ，如能得到下面的结果则说明 mod_perl 工作正常。
Hello, world! This is a CGI.
如果显示 Internal Server Error，可参考 logs/httpd-error.log 文件中的错误信息。
测试 mod_perl Apache Handler 的执行
mod_perl 的另一种执行方法就是编写 Apache Handler。Apache Handler 是一个Perl模块，在 Apache 启动时读入并常驻内存，用来处理Web请求。
在 D:/wwwroot 下建立 lib 目录，用于保存 Perl 模块。我们将建立 HelloWorld::Hello 模块，内容为显示 “Hello, world”。为建立这个模块，我们需要进行以下的工作。
- 建立模块本身
- 将模块的位置放到 @INC 变量中以便 mod_perl 能找到我们建立的模块
- 修改 httpd.conf，设置使用该模块的位置
在 lib 下建立 HelloWorld 目录，并在 HelloWorld 目录下建立 Hello.pm 文件，其内容如下。
package HelloWorld::Hello;
use strict;
use warnings;
use Apache2::RequestRec ();
use Apache2::RequestIO ();
use Apache2::Const -compile => qw(OK);
sub handler {
my $r = shift;
$r->content_type('text/plain');
print "Hello, world! This is an Apache Handler.\n";
return Apache2::Const::OK;
}
1;
书写Perl模块时注意不要忘记最后的 1; ，如果没有的话 mod_perl 会出错。（该文件的完整路径为 D:\wwwroot\lib\HelloWorld\Hello.pm，不要弄错了。）
然后我们需要将 HelloWorld::Hello 模块的位置告诉 mod_perl。在 D:\wwwroot\lib 下建立 startup.pl 文件，内容如下：
use lib qw(D:/wwwroot/lib); 1;
然后修改 httpd.conf，加入下面的设置。
PerlRequire "D:/wwwroot/lib/startup.pl"
现在这个模块已经可以使用了。我们只需告诉 Apache 在什么情况下使用该模块。修改 httpd.conf，加入下面的设置。
<Location /hello>
SetHandler perl-script
PerlResponseHandler HelloWorld::Hello
</Location>
最后重新启动 Apache。在浏览器中打开 http://localhost/hello，应当能看到下面的文字：
Hello, world! This is an Apache Handler.
安装 python 2.3.5
双击 Python-2.3.5.exe 进行安装。默认的安装目录为 C:\Python23。
为什么不使用 python 2.4 或 python 2.5 版本
安装 mod_python
双击 mod_python-3.2.10.win32-py2.3-apache2.0.exe 进行安装。安装程序会检测 Python 和 Apache 的安装路径，并将 mod_python.so 安装至 Apache2/modules 目录下。
打开 Apache2/conf/httpd.conf，查找 LoadModule，并在其附近添加以下内容。
LoadModule python_module modules/mod_python.so
最后重新启动 Apache2。
安装 subversion
subversion是一个优秀的版本控制系统，它能够完整地记录软件开发过程中源代码的变动，并可以随时将源代码恢复到以前的任意版本。subversion的服务器可以单独使用，也可以作为 Apache 的模块，通过 WebDAV 协议使用。
在 subversion 的下载页面上，你会看到关于 Windows 版的说明，简单来讲就是 subversion 没有 Python 2.4 binding，也就是说，使用 Python 2.4 不能对 subversion 进行编程，这也是我们不使用 Python 2.4 的一个原因。
将 svn-win32-1.3.2.zip 解压到 C:\svn 下。由于 svn 的 Apache2 模块需要 C:\svn\bin 下的 intl3_svn.dll 和 libdb43.dll 文件，所以要在环境变量 Path 中增加下面的内容，并重新启动计算机。
C:\svn\bin;
将 C:\svn\bin 下的 mod_dav_svn.so 文件复制到 Apache2/modules 目录下。
打开 Apache2/conf/httpd.conf 文件，然后查找下面这一行，去掉其前面的注释符号 # 。
LoadModule dav_module modules/mod_dav.so
查找 LoadModule，并在其附近添加以下内容。
LoadModule dav_svn_module modules/mod_dav_svn.so
最后重新启动 Apache2。