Unix 系统上的 Apache 2.x

本节包含有关在 Unix 系统上安装 Apache 2.x 的 PHP 的特定说明和提示。

有关 Apache 2.x 服务器的权威信息来源是 » Apache 文档。更多关于 Apache 安装选项的信息可以在那里找到。

最新版本的 Apache HTTP 服务器可以从 » Apache 下载网站 获得，合适的 PHP 版本可以从上面提到的位置获得。本快速指南仅涵盖开始使用 Apache 2.x 和 PHP 的基础知识。有关更多信息，请阅读 » Apache 文档。为了确保说明不错误，这里省略了版本号。在下面的示例中，'NN' 应替换为正在使用的特定 Apache 版本。

目前有两种版本的 Apache 2.x - 有 2.4 和 2.2。虽然选择每个版本都有各种原因，但 2.4 是当前的最新版本，也是推荐的版本，如果此选项对您可用。但是，这里的说明适用于 2.4 或 2.2。请注意，Apache httpd 2.2 已正式停止维护，不再发布新的开发或补丁。

1. 从上面列出的位置获取 Apache HTTP 服务器，并解压缩它

   tar -xzf httpd-2.x.NN.tar.gz
   

2. 同样，获取并解压缩 PHP 源代码

   tar -xzf php-NN.tar.gz
   

3. 构建并安装 Apache。有关构建 Apache 的更多详细信息，请参阅 Apache 安装文档。

   cd httpd-2_x_NN
   ./configure --enable-so
   make
   make install
   

4. 现在，您拥有了在 /usr/local/apache2 下的 Apache 2.x.NN，配置了可加载模块支持和标准 MPM prefork。要测试安装，请使用您启动 Apache 服务器的正常程序，例如

   /usr/local/apache2/bin/apachectl start
   

   并停止服务器以继续进行 PHP 的配置

   /usr/local/apache2/bin/apachectl stop
   

5. 现在，配置和构建 PHP。这是您使用各种选项自定义 PHP 的地方，例如将启用哪些扩展。运行 ./configure --help 以获取可用选项的列表。在我们的示例中，我们将使用 Apache 2 和 MySQL 支持进行简单的配置。

   如果您从源代码构建了 Apache，如上所述，下面的示例将匹配您 apxs 的路径，但是如果您以其他方式安装了 Apache，则需要相应地调整 apxs 的路径。请注意，某些发行版可能会将 apxs 重命名为 apxs2。

   cd ../php-NN
   ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-pdo-mysql
   make
   make install
   

   如果您决定在安装后更改配置选项，则需要重新运行配置、make 和 make install 步骤。您只需要重新启动 apache 才能使新模块生效。无需重新编译 Apache。

   请注意，除非另有说明，'make install' 还将安装 PEAR、各种 PHP 工具（如 phpize）、安装 PHP CLI 等。

6. 设置您的 php.ini

   cp php.ini-development /usr/local/lib/php.ini
   

   您可以编辑 .ini 文件以设置 PHP 选项。如果您希望将 php.ini 放在其他位置，请在步骤 5 中使用 --with-config-file-path=/some/path。

   如果您选择 php.ini-production，请务必阅读其中的更改列表，因为它们会影响 PHP 的行为。

7. 编辑您的 httpd.conf 以加载 PHP 模块。LoadModule 语句右侧的路径必须指向系统上 PHP 模块的路径。上面的 make install 可能已经为您添加了它，但请务必检查。

   对于 PHP 8

   LoadModule php_module modules/libphp.so

   对于 PHP 7

   LoadModule php7_module modules/libphp7.so

8. 告诉 Apache 将某些扩展解析为 PHP。例如，让我们让 Apache 将 .php 文件解析为 PHP。我们不希望仅使用 Apache AddType 指令，而是希望避免可能存在危险的上传和创建的文件（如 exploit.php.jpg）被执行为 PHP。使用此示例，您可以通过简单地添加它们来使任何扩展名解析为 PHP。我们将添加 .php 来演示。

   <FilesMatch \.php$>
       SetHandler application/x-httpd-php
   </FilesMatch>

   或者，如果我们希望允许 .php、.php2、.php3、.php4、.php5、.php6 和 .phtml 文件被执行为 PHP，但其他文件不被允许，则可以使用以下命令

   <FilesMatch "\.ph(p[2-6]?|tml)$">
       SetHandler application/x-httpd-php
   </FilesMatch>

   要允许 .phps 文件由 php 源代码过滤器处理并显示为语法高亮显示的源代码，请使用以下命令

   <FilesMatch "\.phps$">
       SetHandler application/x-httpd-php-source
   </FilesMatch>

   mod_rewrite 可用于允许任何任意的 .php 文件被显示为语法高亮显示的源代码，而无需将其重命名或复制到 .phps 文件

   RewriteEngine On
   RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source]

   php 源代码过滤器不应该在生产系统上启用，因为在生产系统上，它可能会公开嵌入在源代码中的机密或敏感信息。

9. 使用您启动 Apache 服务器的正常程序，例如

   /usr/local/apache2/bin/apachectl start
   

   或者

   service httpd restart
   

按照上述步骤，您将拥有一个运行的 Apache2 Web 服务器，它支持 PHP 作为 SAPI 模块。当然，Apache 和 PHP 提供了更多配置选项。有关更多信息，请在相应的源代码树中键入 ./configure --help。

Apache 可以通过在构建 Apache 时选择 worker MPM 而不是标准的 prefork MPM 来构建多线程。这可以通过在上面的步骤 3 中传递给 ./configure 的参数中添加以下选项来完成

--with-mpm=worker

在没有意识到此决定的后果，并且至少对这些含义有一定了解的情况下，不应该这样做。有关 » MPM-模块 的 Apache 文档更详细地讨论了 MPM。

注意:

Apache MultiViews 常见问题解答 讨论了将 multiviews 与 PHP 一起使用。

注意:

要构建 Apache 的多线程版本，目标系统必须支持线程。在这种情况下，PHP 也应该使用 Zend Thread Safety (ZTS) 构建。在这种配置下，并非所有扩展都可用。建议的设置是使用默认的 prefork MPM-模块构建 Apache。