XAMPP升级PHP版本后，多端口失效是开发中常见的问题，核心原因大多和Apache配置文件的变更有关，下面我们逐步分析并解决该问题。
一、问题排查步骤
1. 检查端口监听配置
首先打开XAMPP安装目录下的Apache/conf/httpd.conf文件，查看是否保留了之前添加的端口监听规则。升级PHP版本时，安装程序可能会覆盖原有的配置文件，导致新增的端口监听记录丢失。
正常的监听配置示例如下，如果你之前配置了8080、8081等端口，需要确保这些规则存在：
# 监听默认80端口 Listen 80 # 监听自定义端口8080 Listen 8080 # 监听自定义端口8081 Listen 8081
2. 检查虚拟主机配置
多端口通常需要配合虚拟主机配置实现，打开Apache/conf/extra/httpd-vhosts.conf文件，确认虚拟主机配置是否完整。如果升级后该文件被重置，就需要重新添加对应的虚拟主机规则。
以下是一个标准的多端口虚拟主机配置示例：
# 80端口对应的项目
<VirtualHost *:80>
ServerName localhost
DocumentRoot "D:/xampp/htdocs/project1"
<Directory "D:/xampp/htdocs/project1">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
# 8080端口对应的项目
<VirtualHost *:8080>
ServerName localhost:8080
DocumentRoot "D:/xampp/htdocs/project2"
<Directory "D:/xampp/htdocs/project2">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
3. 检查PHP模块加载
升级PHP版本后，需要确认Apache是否正确加载了对应版本的PHP模块。回到httpd.conf文件，查找PHP模块加载配置，确保路径指向升级后的PHP目录。
以PHP8.1为例，正确的加载配置如下：
# 加载PHP模块，路径根据实际安装位置调整 LoadModule php_module "D:/xampp/php/php8ts.dll" AddHandler application/x-httpd-php .php # 配置PHP配置文件路径 PHPIniDir "D:/xampp/php"
二、常见解决操作
1. 恢复配置文件
如果升级前备份过httpd.conf和httpd-vhosts.conf文件，可以直接将备份文件覆盖到对应目录，然后重启Apache服务。如果没有备份，就按照上述排查步骤重新添加对应的配置规则。
2. 开启虚拟主机扩展
部分版本升级后，虚拟主机扩展的配置会被注释掉，需要在httpd.conf中找到以下配置，去掉前面的#号开启扩展：
# 去掉前面的#号，开启虚拟主机配置 Include conf/extra/httpd-vhosts.conf
3. 检查端口占用情况
如果配置都正确但端口还是无法访问，可能是自定义端口被其他程序占用。可以打开命令行执行以下命令查看端口占用情况：
# 查看8080端口占用情况，替换为你的自定义端口 netstat -ano | findstr "8080"
如果查询到有进程占用，可以结束对应进程，或者更换一个未被占用的端口重新配置。
三、验证配置生效
完成所有配置修改后，打开XAMPP控制面板重启Apache服务，然后在浏览器中分别访问http://localhost、http://localhost:8080等地址，确认不同端口都能正常打开对应的项目，就说明多端口配置已经恢复生效。
如果重启Apache时提示配置错误，可以查看XAMPP控制面板的Apache日志，根据错误提示调整对应的配置规则即可。
XAMPPPHP多端口配置Apachehttpd_conf修改时间：2026-07-03 11:12:23