PHP配置虚拟主机教程详解

本文详细讲解了在Apache服务器上为PHP项目配置虚拟主机的完整流程，涵盖启用关键模块、设置基于名称的虚拟主机、绑定本地域名、正确集成PHP处理器以及重启验证等核心步骤，帮助开发者轻松实现多域名或多项目的本地或服务器独立部署，确保PHP网站安全、高效、可维护地运行。

如果您在本地或服务器上部署PHP网站，需要为不同域名或项目分配独立的Web服务空间，则必须通过Apache配置虚拟主机。以下是完成PHP网站虚拟主机配置的具体步骤：

一、启用Apache虚拟主机模块

Apache默认可能未启用虚拟主机核心模块，需确保mod_rewrite和mod_vhost_alias处于激活状态，否则基于名称的虚拟主机无法正常路由请求。

1、打开Apache主配置文件httpd.conf（Linux路径通常为/etc/apache2/apache2.conf或/usr/local/etc/httpd/httpd.conf；Windows下常见于C:\Apache24\conf\httpd.conf）。

2、查找并取消注释以下两行（若存在且被#号注释）：
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so

3、确认Include指令已加载虚拟主机配置文件，例如：Include conf/extra/httpd-vhosts.conf或IncludeOptional sites-enabled/*.conf。

二、配置基于名称的虚拟主机

基于名称的虚拟主机允许多个域名共享同一IP和端口，Apache依据HTTP请求头中的Host字段分发请求，适用于大多数PHP站点部署场景。

1、编辑虚拟主机配置文件（如httpd-vhosts.conf或新建/etc/apache2/sites-available/mysite.conf）。

2、插入如下结构化配置块：

  ServerName example.local
  ServerAlias www.example.local
  DocumentRoot "/var/www/example"
  
    AllowOverride All
    Require all granted
  

3、将example.local替换为实际使用的域名，/var/www/example替换为PHP项目所在绝对路径。

4、确保该目录存在且Apache用户（如www-data或daemon）具有读取权限。

三、修改本地hosts文件绑定域名

在未使用真实DNS解析的情况下，需通过操作系统hosts文件将自定义域名映射至本地回环地址，使浏览器可识别并访问虚拟主机。

1、Linux/macOS系统中，使用sudo权限编辑/etc/hosts文件。

2、Windows系统中，以管理员身份打开C:\Windows\System32\drivers\etc\hosts。

3、在文件末尾新增一行：127.0.0.1 example.local

4、保存文件后，清除系统DNS缓存：Linux/macOS执行sudo dscacheutil -flushcache或sudo systemd-resolve --flush-caches；Windows执行ipconfig /flushdns。

四、配置PHP处理器与MIME类型支持

Apache需明确识别PHP文件扩展名并调用PHP模块执行，否则将直接返回源码或下载文件，而非渲染输出。

1、确认libphp.so（Unix）或php7apache2_4.dll（Windows）已加载，查找类似LoadModule php_module modules/libphp.so的行并取消注释。

2、添加PHP处理指令至主配置或虚拟主机块内：

  SetHandler application/x-httpd-php


3、在段中加入：
AddType application/x-httpd-php .php .phtml

4、验证PHP是否生效：在DocumentRoot目录下创建info.php，内容为，通过浏览器访问http://example.local/info.php。

五、重启Apache服务并验证配置语法

配置变更后必须重载服务才能生效，但错误配置可能导致Apache启动失败，因此需先校验语法正确性。

1、执行配置检查命令：apachectl configtest（Linux/macOS）或httpd -t（Windows）。

2、若输出Syntax OK，继续执行服务重启：
Ubuntu/Debian：sudo systemctl restart apache2
CentOS/RHEL：sudo systemctl restart httpd
Windows：net stop Apache2.4 && net start Apache2.4

3、访问http://example.local，确认PHP页面正常响应且无500/403错误。

本篇关于《PHP配置虚拟主机教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！