想让手机直接打开你电脑上跑的 Symfony 应用吗？WebServerBundle是 Symfony 官方的 Web 服务器扩展包，它基于 PHP 内置 Web 服务器提供server:run等命令，免去配置 Apache 或 Nginx 的麻烦。本指南手把手教你通过0.0.0.0 绑定把本地服务器暴露到局域网，让手机、平板在同一 Wi-Fi 下即时访问开发环境。

为什么手机打不开你的本地服务器？

默认情况下，server:run只监听127.0.0.1这个回环地址——它只对当前电脑自己开放，局域网里的手机自然连不进来。

这个默认逻辑写在 WebServerConfig.php 中：不传参数时，主机名固定为127.0.0.1，端口则从 8000 起自动寻找第一个空闲端口（上限 8100），见 WebServerConfig.php。

💡 也就是说：想被手机访问，只需在启动命令里指定监听地址为0.0.0.0。

一键局域网暴露：0.0.0.0 绑定启动命令

如何绑定所有网络接口

在项目根目录执行（--docroot指向你的入口目录，通常是public/）：

php bin/console server:run 0.0.0.0:8000 --docroot=public/

addressport参数支持地址:端口、纯地址或纯端口三种写法，定义见 ServerRunCommand.php。

小技巧：地址里直接用通配符*也可以，它会被自动映射为0.0.0.0（该特性自 3.4.0 加入，见 CHANGELOG.md）：

php bin/console server:run *:8000 --docroot=public/

看懂控制台输出的访问地址

绑定到0.0.0.0后，控制台会打印类似提示：

[OK] Server listening on all interfaces, port 8000 -- see http://192.168.1.100:8000

程序会自动解析出你机器的本机地址并拼上端口，源码见 WebServerConfig.php。把这一行地址复制到手机浏览器即可打开，非常方便。

手机端访问 Symfony 开发环境的正确姿势

三步搞定手机访问

1. 确认同一网络：手机与电脑连接同一个 Wi-Fi（或手机开热点给电脑连）。
2. 查看电脑局域网 IP：Windows 用ipconfig，macOS/Linux 用ip addr（或ifconfig），找到192.168.x.x或192.168.31.x之类的地址。
3. 手机浏览器输入：http://电脑IP:8000，例如http://192.168.1.100:8000。

能正常打开首页，就说明 0.0.0.0 绑定生效了 🎉

后台运行与状态查看：server:start / status / stop

server:run会阻塞终端。如果需要腾出终端继续写代码，可以用后台模式（Linux/macOS 需要pcntl扩展）：

# 后台启动 php bin/console server:start 0.0.0.0:8000 --docroot=public/ # 查看当前监听地址 php bin/console server:status # 停止服务器 php bin/console server:stop

底层其实是调用 PHP 的php -S内置服务器，并附带一个路由脚本 router.php 实现类似.htaccess的重写规则，进程管理逻辑在 WebServer.php。

常见问题与排查技巧

• 手机转圈打不开：多半是电脑防火墙拦了端口。Windows 需在"高级防火墙"中放行 8000 端口的入站规则；macOS 首次弹出提示时选择"允许连接"。
• 提示端口被占用：默认从 8000 开始自动找空闲端口直到 8100，超范围会报错，换个端口号即可。
• 报 "pcntl extension" 错误：server:start依赖pcntl扩展，Windows 上建议直接用server:run前台运行。
• 同一地址重复启动失败：提示A process is already listening时，先执行server:stop再重启。
• 提示 "Running this server in production environment is NOT recommended"：该服务器仅面向开发场景，生产环境请使用正式 Web 服务器，此限制见 ServerRunCommand.php。

⚠️安全提醒：绑定0.0.0.0后，局域网内任何设备都能访问你的开发应用。请只在家庭或公司可信网络中使用，不要用于暴露到公网，用完及时server:stop。

版本提示：新版本已改用 Symfony Local Web Server

自 Symfony 4.4 起，WebServerBundle 已被标记为废弃（详见 README.md 与 CHANGELOG.md），官方推荐使用新的Symfony Local Web Server（bin/server:run），它同样支持绑定到0.0.0.0让手机访问，且功能更丰富。新项目建议直接使用新服务器，老项目用本文方法依然完全可行。

总结

记住核心口诀：一个0.0.0.0绑全网，一个局域网 IP 进手机，三步就能让手机实时预览你的 Symfony 应用。