XAMPP配置多端口导致的URL乱码问题-php教程-PHP中文网

xampp修改apache端口后中文参数乱码的根源是uriencoding未设为utf-8，必须在对应块内显式添加uriencoding utf-8并重启整个xampp服务。

xampp配置多端口导致的url乱码问题

XAMPP 默认不处理多端口下的 URL 编码，直接改 Apache 端口后中文参数会变成乱码，根源是 URIEncoding 没同步生效。

Apache 修改监听端口后必须显式设置 `URIEncoding="UTF-8"`

很多人在 httpd.conf 里改了 Listen 8080 或新增了 Listen 8000，以为端口通了就万事大吉。但 Apache 对 URL 路径和查询参数的解码默认用的是 ISO-8859-1，遇到中文就会丢字节。

解决方法不是改 PHP 或前端，而是回到 Apache 配置本身：

打开 /opt/lampp/etc/httpd.conf（Linux）或 \xampp\apache\conf\httpd.conf（Windows）
找到你新增或修改的 <virtualhost></virtualhost> 或默认的 <virtualhost></virtualhost> 块
在该块内添加一行：SetEnvIf Request_URI ".*" no-gzip 不需要；真正要加的是：SetEnvIf Request_URI ".*" no-gzip —— 错，删掉；正确是：RequestHeader set Accept-Encoding "gzip,deflate" —— 也不对。停，只加这一行：URIEncoding UTF-8
注意：这行不能写在全局配置区，必须放在对应 <virtualhost></virtualhost> 内，否则不生效

`httpd-vhosts.conf` 中虚拟主机未继承编码设置

如果你用 httpd-vhosts.conf 配了多个域名或端口（比如 dev.local:8000），Apache 默认不会把主配置里的编码规则自动透传过去。即使你在 httpd.conf 里写了 URIEncoding UTF-8，它对虚拟主机无效。

必须在每个 <virtualhost></virtualhost> 块中单独声明：

 <virtualhost>
    DocumentRoot "/opt/lampp/htdocs/myapp"
    ServerName dev.local
    URIEncoding UTF-8
</virtualhost>

遗漏这点，哪怕端口能访问、PHP 脚本能跑，$_GET['q'] 取到的仍是乱码字符串，比如 %E4%BD%A0%E5%A5%BD 解出来是 ä½ å¥½ 而不是 “你好”。

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

PHP 接收前已损坏，`urldecode()` 无法挽救

有人试过在 PHP 里对 $_GET 做二次解码：urldecode($_GET['name']) 或 iconv('ISO-8859-1', 'UTF-8', $_GET['name'])。这治标不治本——因为 Apache 在解析 URL 阶段就已经按 ISO-8859-1 错误拆分了字节流，原始 UTF-8 字节序列早已被破坏，再怎么转都救不回。

验证是否真被破坏的方法很简单：

用 bin/bash -c 'echo -n "你好" | xxd' 查看原始 UTF-8 十六进制是 e4 bd a0 e5,a5 bd
如果 Apache 解错，$_GET 里收到的可能是 c3 a4 c2 bd c2 a0 c3 a5 这类乱序字节，urldecode() 完全无从下手

所以别在 PHP 层兜底，必须让 Apache 在入口就把编码定死。

MySQL 和 phpMyAdmin 不受影响，但路径重写会放大问题

注意：URIEncoding 只影响 HTTP 请求路径和查询字符串，不影响 MySQL 连接或 phpMyAdmin 的页面显示。但如果你用了 RewriteRule 做路由（比如 ThinkPHP 的 PATHINFO 模式），而重写规则里又含中文路径，那没设 URIEncoding 就会导致 %{REQUEST_URI} 变量内容错乱，重写直接失败或跳转错误地址。

这种情况下，连 ErrorLog 里都会出现类似 Invalid URI in request GET /%C3%A4%C2%BD%C2%A0 的记录，说明 Apache 自己都认不出这个 URI 了。

最易被忽略的是：改完配置后必须重启整个 XAMPP（不只是 Apache），否则 httpd 进程不会重新加载 VirtualHost 块里的新指令。用 sudo /opt/lampp/lampp restart 或 Windows 下点控制面板的 “Stop All” 再 “Start All” 才算真正生效。