XAMPP环境下多端口部署Mezzio框架

在XAMPP环境下部署Mezzio框架，Apache启动失败、项目无法访问、PHP模块缺失、Composer autoload失效这四类问题经常扎堆出现，而且背后往往有隐藏关联。不是改一处端口、装一个包就能解决的——每一步都踩过坑的人会明白，它们之间环环相扣，任何一个环节没对齐，后续就会直接报错。

Apache启动失败：端口被占用或配置未生效

Mezzio 是基于 PSR-15 的轻量级 PHP 框架，本身不带 Web 服务器，必须依赖 Apache 或 Nginx。XAMPP 默认用 80 和 443 端口，但在 Windows 上，Skype、IIS、VMware Hostd（PID 5728），甚至系统进程（PID 4）都会跑来抢占这些端口。没有足够的权限，Apache 根本绑定不了。

直接改 httpd.conf 不够——XAMPP 控制面板会读取自身缓存，必须同步更新两处：

• xampp\apache\conf\httpd.conf：修改 Listen 80 → Listen 8081，以及 ServerName localhost:80 → ServerName localhost:8081
• xampp\apache\conf\extra\httpd-ssl.conf：修改所有 Listen 443 → Listen 8443，并更新 VirtualHost _default_:443 为 _default_:8443

改完别急着点 Start——先右键 xampp-control.exe → “以管理员身份运行”，否则 Windows 防护机制会拒绝绑定非特权端口（尤其是 80/443 以外的高编号端口，有时也会被拦截）。

Mezzio项目无法通过localhost:8081访问

端口通了并不代表万事大吉。Mezzio 要求入口统一走 public/index.php，而 XAMPP 默认 DocumentRoot 指向 xampp\htdocs，直接把 Mezzio 项目丢进去，会遇到 404 或直接暴露敏感文件。

正确做法是配虚拟主机，让 mezzio.local 指向项目根目录下的 public 子目录：

• 在 xampp\apache\conf\extra\httpd-vhosts.conf 末尾追加：

    ServerName mezzio.local
    DocumentRoot "C:/path/to/mezzio/public"
    
        AllowOverride All
        Require all granted
    

然后在系统 C:\Windows\System32\drivers\etc\hosts 里加一行：127.0.0.1 mezzio.local。重启 Apache 后，访问 http://mezzio.local:8081 才能正常路由。

PHP模块缺失导致Mezzio启动报错

Mezzio 依赖 mbstring、xml、curl、json，XAMPP 自带的 PHP 有时默认禁用了部分扩展。启动时若报 Class 'Mezzio\Application' not found 或 mb_detect_encoding(): mbstring extension is not a vailable，基本可以确定是模块没开。

打开 xampp\php\php.ini，确认以下行前面的分号已去掉：

• extension=mbstring
• extension=xml
• extension=curl
• extension=openssl

改完必须重启 Apache——仅重启控制面板不够，要彻底 Stop 再 Start，否则 PHP 模块不会重载。

多端口共存时 Composer autoload 失效

如果同时跑多个 Mezzio 实例（比如 mezzio.local:8081 和 mezzio-dev.local:8082），且都用 composer install --no-dev 部署，容易出现 Class not found。问题根源是 XAMPP 的 PHP CLI 和 Apache 加载的 php.ini 文件路径不同：

• Apache 用的是 xampp\php\php.ini
• CLI 常调用 xampp\php\php.ini，但某些版本会 fallback 到系统级配置，导致 vendor/autoload.php 路径解析错乱

验证方式：在项目根目录运行 php -m | findstr mbstring，看 CLI 是否加载了模块；再在 public/index.php 开头加 var_dump(php_ini_loaded_file()); 确认 Apache 实际加载的 ini 路径。两者不一致就必须统一指向同一份 php.ini，否则 autoload 逻辑会因环境差异断裂。