XAMPP环境下多端口部署Lumen框架-php教程-PHP中文网

xampp本身不支持为每个lumen项目自动分配独立端口，必须手动配置apache虚拟主机、指定各项目public目录为documentroot、确保.env中app_url与实际访问url（含端口）完全一致，否则路由、重定向及资产链接全部失效。

xampp环境下多端口部署lumen框架

直接说结论：XAMPP本身不支持为每个Lumen项目自动分配独立端口，必须手动改Apache配置+调整Lumen的public路径+注意.env中APP_URL与实际访问地址一致，否则路由、重定向、资产链接全崩。

为什么不能直接把Lumen项目丢进htdocs就跑多端口

XAMPP的Apache默认只监听一个端口（80或8080），所有htdocs下的子目录都共享这个端口和同一套DocumentRoot。Lumen又依赖public/作为Web入口，若多个项目共存于htdocs下，比如htdocs/lumen-api和htdocs/lumen-admin，它们会共用同一个.htaccess规则、同一个index.php引导逻辑，且无法隔离PHP-FPM或环境变量——本质是“单入口多目录”，不是“多端口多实例”。

你访问http://localhost:8080/lumen-api时，Apache仍走的是htdocs根目录的index.php，除非你手动在public/index.php里做路径劫持，但Lumen不推荐也不兼容这种hack
APP_URL=http://localhost:8080写死后，生成的JWT签名、邮件链接、API响应里的self链接都会带:8080，但若另一个项目想用:8081，就得改代码，不可维护
Apache的Alias或Redirect无法正确传递PATH_INFO，导致Lumen的路由解析失败，报404 Not Found而不是405 Method Not Allowed

正确做法：用虚拟主机+独立端口绑定

核心是让每个Lumen项目拥有自己的VirtualHost，并绑定到不同端口（如8080、8081、8082），这样它们互不干扰，也能各自配DocumentRoot指向各自的public/目录。

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

下载

编辑\xampp\apache\conf\extra\httpd-vhosts.conf，取消顶部#Include conf/extra/httpd-vhosts.conf的注释（如果被注释）
在文件末尾追加两个<virtualhost></virtualhost>块，例如：

Listen 8080
Listen 8081

<virtualhost>
    DocumentRoot "C:/xampp/htdocs/lumen-api/public"
    ServerName localhost:8080
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost><virtualhost>
    DocumentRoot "C:/xampp/htdocs/lumen-admin/public"
    ServerName localhost:8081
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost>

保存后重启Apache；验证是否生效：netstat -ano | findstr :8080和findstr :8081应各显示一行LISTENING
每个项目.env中设对应APP_URL=http://localhost:8080或APP_URL=http://localhost:8081，别漏掉端口号

常见错误：.htaccess没起作用或重写失效

Lumen依赖mod_rewrite做URL重写，而XAMPP默认关闭了AllowOverride或没启用模块，导致public/.htaccess被忽略，所有请求都落到index.php但没走路由，直接返回首页或404。

确认\xampp\apache\conf\httpd.conf中这三行已取消注释：

LoadModule rewrite_module modules/mod_rewrite.so
Include conf/extra/httpd-vhosts.conf
<directory>
    AllowOverride All
    Require all granted
</directory>

每个<virtualhost></virtualhost>块内的<directory></directory>段也必须显式写AllowOverride All，不能依赖全局设置
Windows下路径分隔符用正斜杠/，别用反斜杠\，否则Apache启动失败且无明确报错
检查public/.htaccess内容是否为Lumen官方默认（含RewriteEngine On和RewriteRule规则），别被IDE自动格式化删掉空行或缩进

调试时最易忽略的点：PHP版本与扩展冲突

多个Lumen项目可能要求不同PHP版本（比如一个用PHP 8.0跑Lumen 8.x，另一个用PHP 8.2跑Lumen 10.x），但XAMPP只装一套PHP，php.exe全局生效。一旦某个项目因mbstring或openssl扩展缺失而报错，它不会提示“扩展未启用”，而是抛出模糊的Class 'Illuminate\Foundation\Application' not found。

每个项目根目录运行php -m | findstr "mbstring openssl tokenizer xml"（Windows）或php -m | grep -E "mbstring|openssl|tokenizer|xml"（Linux/macOS），确认必需扩展都在列表里
执行php -v看输出是否含NTS标识；若用TS版PHP，某些Composer包安装会静默失败
别信phpinfo()页面里显示的“Loaded Configuration File”，要以命令行php --ini输出为准——XAMPP有时会加载php.ini-development而非php.ini-production，导致display_errors=Off掩盖真实问题

端口数字本身不重要，重要的是每个VirtualHost的DocumentRoot必须精确到public/，且.env中的APP_URL必须和浏览器实际访问的URL完全一致（协议、域名、端口、末尾斜杠），差一个字符，Lumen的URL生成器就会出错。这不是配置技巧，是Lumen底层对url()和route()函数的硬性依赖。