在Ubuntu上安装并配置Apache2 + PHP

今天笔者决定要重新学习PHP，以应聘后端开发的相关职位，遂拿出我安装了Linux Mint 19.3（基于Ubuntu 18.04）的笔记本，安装Apache2+PHP开发环境。查阅了不少资料，然而相关资料非常散装，折腾了一个多小时，遂把折腾的心得，整理成这篇教程。

安装

安装Apache2

只需运行以下命令即可安装Apache2：

sudo apt install apache2

默认情况下，Apache2会安装成一项系统服务，日后可以通过/etc/init.d/apache2和systemctl apache2来进行管理。通过以下命令检测Apache2是否安装上：

$ sudo /etc/init.d/apache2 stop
[ ok ] Stopping apache2 (via systemctl): apache2.service.
$ sudo /etc/init.d/apache2 start
[ ok ] Starting apache2 (via systemctl): apache2.service.
$ sudo /etc/init.d/apache2      
Usage: apache2 {start|stop|graceful-stop|restart|reload|force-reload}

注意：新版本的Apache2已经废弃了组件httpd，由可执行文件apache2替代。

安装PHP

Ubuntu 18.04默认提供的PHP版本是7.2，可以采用“宏包”的形式安装——安装一个php包，就可以安装上所有基本的PHP组件：

sudo apt install php

运行后，从APT的输出结果可以看出，必要的组件都将会装上，其中包括Apache2服务器上的PHP模块：

Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following additional packages will be installed:
  apache2-bin libapache2-mod-php7.2 libapr1 libaprutil1
  libaprutil1-dbd-sqlite3 libaprutil1-ldap php-common php7.2 php7.2-cli
  php7.2-common php7.2-json php7.2-opcache php7.2-readline
Suggested packages:
  apache2-doc apache2-suexec-pristine | apache2-suexec-custom php-pear
Recommended packages:
  apache2
The following NEW packages will be installed:
  apache2-bin libapache2-mod-php7.2 libapr1 libaprutil1
  libaprutil1-dbd-sqlite3 libaprutil1-ldap php php-common php7.2 php7.2-cli
  php7.2-common php7.2-json php7.2-opcache php7.2-readline
0 upgraded, 14 newly installed, 0 to remove and 1 not upgraded.
Need to get 5,133 kB of archives.
After this operation, 21.9 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

安装完成后，可以运行php -v来检测PHP是否安装好。安装成功后，会显示版本信息：

$ php -v
PHP 7.2.24-0ubuntu0.18.04.1 (cli) (built: Oct 28 2019 12:07:07) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.2.24-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

安装PHP模块

Ubuntu中的PHP模块均使用软件包提供，需要什么模块就安装哪个包，例如MySQL和cUrl模块：

sudo apt install php-mysql php-curl

这些包也是宏包，不带版本号，默认会安装与当前PHP对应的版本。

配置

Windows下的集成包Wamp Server和XAMPP是开箱即用的，意味着安装后无需专门进行配置，即可直接使用Apache2和PHP。但手动安装的Apache2和PHP都不行，必须费一番功夫折腾配置文件。

主要涉及到的配置文件有：

• /etc/apache2/apache2.conf：主配置文件。它可以用Include指令来包含其他的配置文件。
• /etc/apache2/sites-avaliable/：存放站点配置文件的目录。一个Apache2服务器可以运行多个站点。
• /etc/apache2/sites-enabled/：启用的站点配置文件，存放sites-available中配置文件的链接，想启用哪个就吧哪个链接进来。貌似把配置文件本体放进来是不会起作用的。

其他供参考的配置文件：

• /etc/apache2/mods-avaliable/：存放模块配置文件的目录。Apache2服务器可以加载各种模块，PHP语言支持正是用模块来提供的。
  • 这里的配置文件又有两种类型（语法完全相同）：
    • *.conf，为模块的配置信息，相当于apache2.conf的补充；
    • *.load，为模块自动加载的入口文件，里面的内容为LoadModule指令。
• /etc/apache2/mods-enabled/：与sites-enabled/类似，想启用哪个模块，就把哪个模块的配置文件链接进来。

注意：新版本的Apache2已经不再使用httpd.conf作为配置文件，它的作用被apache2.conf和其他附属配置文件取代。

修改站点配置文件

Apache2配置文件有专门的语法，其中，每个配置项的格式为：配置项名 配置值。

安装Apache2后，站点配置文件中就有了一个默认的配置：000-default.conf。

一般需要修改或添加以下配置项：

• ServerName：服务器的域名。
  • 在本地开发PHP的，把域名设置为localhost即可。
• DocumentRoot：站点文件的根目录，例如index.html等文件要存放的目录。
  • 默认为/var/www/或/var/www/html/。
  • 将它改为你用户主目录下的一个目录。这里使用/home/username/.apache/default_site。
• DirectoryIndex：站点入口文件名，即未输入网页文件名时，Apache2会给你加载的文件名。
  • 将它设为index.html index.htm index.php。

修改后的配置文件大致如下所示：

<VirtualHost *:80>
	ServerName localhost 

	ServerAdmin webmaster@localhost
	DocumentRoot /home/username/.apache/default_site/

	DirectoryIndex index.html index.htm index.php

	ErrorLog ${APACHE_LOG_DIR}/error.log
	CustomLog ${APACHE_LOG_DIR}/access.log combined

	# For most configuration files from conf-available/, which are
	# enabled or disabled at a global level, it is possible to
	# include a line for only one particular virtual host. For example the
	# following line enables the CGI configuration for this host only
	# after it has been globally disabled with "a2disconf".
	#Include conf-available/serve-cgi-bin.conf
</VirtualHost>

修改目录权限

设置站点的DocumentRoot后，默认情况下用户是没有它的访问权限的，这时如果直接使用localhost访问，会提示“403 Forbidden”。

解决办法是，在apache2.conf中添加新DocumentRoot目录的权限。配置文件中管理目录权限的段如下所示：

# Sets the default security model of the Apache2 HTTPD server. It does
# not allow access to the root filesystem outside of /usr/share and /var/www.
# The former is used by web applications packaged in Debian,
# the latter may be used for local directories served by the web server. If
# your system is serving content from a sub-directory in /srv you must allow
# access here, or in any related virtual host.
<Directory />
	Options FollowSymLinks
	AllowOverride None
	Require all denied
</Directory>

<Directory /usr/share>
	AllowOverride None
	Require all granted
</Directory>

<Directory /var/www/>
	Options Indexes FollowSymLinks
	AllowOverride None
	Require all granted
</Directory>

可见，几个默认的目录都有相应的权限配置。因此我们也需要把自己的DocumentRoot目录加进来，添加以下内容到这一部分（或文件尾部）：

<Directory /home/username/.apache>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
</Directory>

重启服务器

要想设置生效，必须重启服务器。运行以下命令重启Apache2：

/etc/init.d/apache2 restart

或者是

sudo systemctl apache2 restart

检查服务器是否能访问

在DocumentRoot中新建一个index.php：

<?php
    echo phpinfo();
?>

然后打开浏览器，访问 http://localhost 或 http://127.0.0.1，出现PHP的详细信息，即配置成功。

解决问题

无法使用PHP

一般地，PHP的宏包会同时安装好Apache2的PHP模块 libapache2-mod-php7.2，不仅会放置模块的文件，更会在/etc/apache2/mods-avaliable中放置好相应的配置文件，无需手动添加PHP的支持。因此，安装宏包（或单独安装PHP模块）后，Apache2服务器就能自动支持PHP。

但是总会有一些异常原因，使得服务器不能解析PHP文件（例如先安装PHP再安装Apache2）。可按照以下办法解决。

(1) 排查是否未启用PHP模块

使用apache2ctl来查看当前已加载的模块列表：

apachectl -M | grep php

如果PHP模块已加载，则会输出下面结果，否则为空：

php7 module (shared)

(2) 重新安装PHP支持模块

如果上述命令找不到PHP模块，则Apache2的PHP模块可能已丢失，运行以下命令以补上：

sudo apt install libapache2-mod-php7.2

(3) 手工启用PHP模块

如果libapache2-mod-php7.2已经安装，却仍无法启动，则可尝试手动启用：

sudo a2enmod php7.2

期间会自动处理模块之间的依赖关系，输出如下结果：

Considering dependency mpm_prefork for php7.2:
Considering conflict mpm_event for mpm_prefork:
Considering conflict mpm_worker for mpm_prefork:
Enabling module mpm_prefork.
Considering conflict php5 for php7.2:
Enabling module php7.2.
To activate the new configuration, you need to run:
  systemctl restart apache2

如果发生如下依赖关系的错误，则可先禁用掉相应的模块，然后再启用。笔者的处理过程如下：

$ sudo a2enmod php7.2
Considering dependency mpm_prefork for php7.2:
Considering conflict mpm_event for mpm_prefork:
ERROR: Module mpm_event is enabled - cannot proceed due to conflicts. It needs to be disabled first!
Considering conflict mpm_worker for mpm_prefork:
ERROR: Could not enable dependency mpm_prefork for php7.2, aborting

$ sudo a2dismod mpm_event
Module mpm_event disabled.
To activate the new configuration, you need to run:
  systemctl restart apache2

$ sudo a2enmod php7.2 
Considering dependency mpm_prefork for php7.2:
Considering conflict mpm_event for mpm_prefork:
Considering conflict mpm_worker for mpm_prefork:
Enabling module mpm_prefork.
Considering conflict php5 for php7.2:
Enabling module php7.2.
To activate the new configuration, you need to run:
  systemctl restart apache2

最后，重新启动Apache2，使更改生效：

/etc/init.d/apache2 restart

参考资料

• [Apache] Forbidden 403 错误原因与解决
• ubuntu apache2配置
• apache2 不支持php文件 解决办法
• Ubuntu 配置 Apache, MySQL, PHP 以及 phpMyAdmin 过程记录
• Ubuntu Apache配置及开启mod_rewrite模块

赏

谢谢你请我吃糖果

支付宝

微信

• 本文作者： 爱拼安小匠
• 本文链接： https://anclark.github.io/2019/12/28/PHP/在Ubuntu上配置Apache2+PHP/
• 版权声明： 本博客所有文章除特别声明外，均采用 CC BY-NC-ND 3.0（署名-非商用-禁止演绎 3.0） 许可协议。转载请注明出处！