如何用Sail包在Docker容器运行Lumen？解决路由不可达问题

核心问题：PHP内置服务器绑定地址错误 #

你当前的Supervisor配置里，PHP内置服务器绑定的是localhost:80，这会让服务器仅监听容器内部的回环地址，宿主机或外部请求根本无法到达容器内的服务。

修复步骤 #

1. 修改Supervisor启动命令
   将命令中的localhost替换为0.0.0.0，让服务器监听容器的所有网络接口：

   [program:php]
   command=/usr/bin/php -S 0.0.0.0:80 -t public
   user=sail
   environment=LARAVEL_SAIL="1"
   stdout_logfile=/dev/stdout
   stdout_logfile_maxbytes=0
   stderr_logfile=/dev/stderr
   stderr_logfile_maxbytes=0
   

2. 验证端口映射配置
   确认docker-compose.yml中已将容器的80端口映射到宿主机端口（Sail默认配置为80:80），示例配置如下：

   ports:
       - '80:80'
   

3. 检查Lumen路由与环境配置

   • 确保routes/web.php中存在可测试的路由，比如：

     $router->get('/', function () use ($router) {
         return 'Lumen服务正常运行！';
     });
     

   • 确认.env文件中的APP_URL设置正确，例如APP_URL=http://localhost

4. 重启容器使配置生效
   执行以下命令重启Sail容器：

   ./vendor/bin/sail down && ./vendor/bin/sail up -d
   

额外优化建议 #

如果更倾向于使用Lumen原生的服务启动方式，可以改用artisan serve命令，同样需要绑定0.0.0.0：

command=/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=0.0.0.0 --port=80

该方式更贴合Laravel/Lumen生态，能避免PHP内置服务器的部分兼容性问题。

内容的提问来源于stack exchange，提问作者Mena