XAMPP本身不支持为每个Lumen项目自动分配独立端口，必须手动配置Apache虚拟主机、指定各项目public目录为DocumentRoot、确保.env中APP_URL与实际访问URL（含端口）完全一致，否则路由、重定向及资产链接全部失效。
直接说结论：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 是一款免费、开源的跨平台 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>块，例如：
Listen 8080
Listen 8081
<VirtualHost *:8080>
DocumentRoot "C:/xampp/htdocs/lumen-api/public"
ServerName localhost:8080
<Directory "C:/xampp/htdocs/lumen-api/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<VirtualHost *:8081>
DocumentRoot "C:/xampp/htdocs/lumen-admin/public"
ServerName localhost:8081
<Directory "C:/xampp/htdocs/lumen-admin/public">
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 "C:/xampp/htdocs">
AllowOverride All
Require all granted
</Directory>
- 每个
<VirtualHost>块内的<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()函数的硬性依赖。
