XAMPP配置多端口并启用Cache-Control策略-php教程-PHP中文网

xampp同时支持多端口访问和cache-control策略，需独立配对生效：一要修改httpd.conf启用listen端口、取消httpd-vhosts.conf注释、加载mod_expires与mod_headers；二要在每个的内配置expiresactive on及header指令；缺一不可，且须用httpd -t验证语法后重启。

xampp配置多端口并启用cache-control策略

XAMPP 要同时支持多端口访问和 Cache-Control 策略，关键不是“加功能”，而是两件事必须独立配对生效：端口监听与虚拟主机绑定、缓存模块启用与作用域匹配。漏掉任一环节，比如只改 Listen 但没开 mod_expires，或开了缓存但没在 <virtualhost></virtualhost> 里启用，都会导致行为不符合预期。

修改 httpd.conf 启用监听端口和虚拟主机配置

不改这个文件，后续所有配置都无效。重点在三处：

找到 Listen 80 行，在其下方添加你要的端口，例如：Listen 8088、Listen 8099 —— 确保这些端口未被系统其他进程占用（可用 lsof -i :8088 或 netstat -ano | findstr :8088 检查）
找到 #Include conf/extra/httpd-vhosts.conf，删掉开头的 #，让虚拟主机配置真正加载
确认 LoadModule expires_module modules/mod_expires.so 这一行没有被注释（macOS XAMPP 默认可能已启用；Windows 下常被注释）

在 httpd-vhosts.conf 中为每个端口定义 VirtualHost 并启用缓存

每个端口对应一个 <virtualhost></virtualhost> 块，缓存策略不能写在全局，必须嵌套在 <directory></directory> 或直接在 <virtualhost></virtualhost> 内生效。常见错误是把 ExpiresActive On 放在文件顶部或外部，它不会起作用。

正确写法示例（以 8088 端口为例）：

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

下载

<virtualhost>
    ServerName localhost
    DocumentRoot "/opt/lampp/htdocs/wuzisys"
    <directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require local
        # 缓存策略从此开始
        ExpiresActive On
        ExpiresDefault "access plus 1 hour"
        ExpiresByType image/jpg "access plus 1 week"
        ExpiresByType text/css "access plus 1 day"
        Header append Cache-Control "public"
    </directory></virtualhost>

ExpiresActive On 必须在 <directory></directory> 或 <virtualhost></virtualhost> 内；否则 Apache 忽略
Header append Cache-Control "public" 需要 mod_headers 已加载（XAMPP 默认启用，但可检查 httpd.conf 中是否有 LoadModule headers_module modules/mod_headers.so）
路径中不要结尾斜杠，DocumentRoot "/opt/lampp/htdocs/wuzisys" ✅，"/opt/lampp/htdocs/wuzisys/" ❌（部分版本会报 403）

重启前务必验证配置语法，避免 Apache 启动失败

很多人改完就点 XAMPP 控制面板重启，结果 Apache 红灯亮起——其实是配置写错，Apache 拒绝启动。先手动验证：

macOS / Linux：/opt/lampp/bin/httpd -t（路径依你的 XAMPP 安装位置而定）
Windows：D:\xampp\apache\bin\httpd.exe -t
输出 Syntax OK 才代表能安全重启；若报错，会明确指出哪行、哪个文件出问题，比如 Invalid command 'ExpiresActive', perhaps misspelled... 就说明 mod_expires 没加载

另外注意：XAMPP 控制面板有时缓存旧状态，改完配置后如果界面没反应，优先用命令行验证 + 手动 kill 进程再 start，比反复点“Start”更可靠。

浏览器验证 Cache-Control 是否生效

别只看页面能不能打开，要确认响应头里真有 Cache-Control 和 Expires：

Chrome / Edge：F12 → Network → 刷新页面 → 点击任意静态资源（如 style.css 或 logo.png）→ Headers 标签页 → 查看 Response Headers 区域
如果看到 Cache-Control: public, max-age=3600 和 Expires 时间戳，说明生效；如果只有 Cache-Control: no-store 或压根没这行，说明配置未命中该资源路径，或 .htaccess 覆盖了主配置
特别注意：PHP 脚本（.php）默认不走 mod_expires，除非你显式用 AddType 或 FilesMatch 绑定类型，一般只对静态资源生效

最易忽略的一点：XAMPP 自带的 htdocs 目录下若存在 .htaccess 文件，且里面写了 Header unset Cache-Control 或 ExpiresActive Off，它会覆盖 httpd-vhosts.conf 的设置——检查项目根目录有没有这个隐藏文件。