17370845950

本文详解如何将本地开发的 laravel（或其他 php cli server）api 服务暴露到同一 wi-fi 网络下的其他设备，核心是使用 `php artisan serve --host=192.168.x.x` 绑定真实局域网 ip，并规避防火墙与跨域常见问题。

在本地开发中，php artisan serve 默认仅监听 127.0.0.1（即 localhost），这意味着服务仅对本机可见，其他设备即使在同一 Wi-Fi 下也无法访问——这正是你遇到 ERR_CONNECTION_REFUSED 或类似网络错误（如截图所示）的根本原因。

要让其他 PC（例如同事的笔记本或手机）通过你的局域网 IPv4 地址（如 192.168.2.222）成功调用 API，需完成以下关键步骤：

✅ 1. 启动服务时显式绑定局域网 IP

不要依赖默认命令，必须指定 --host 参数为你的实际内网 IPv4 地址（可通过 ipconfig（Windows）或 ifconfig / ip a（macOS/Linux）确认）：

php artisan serve --host=192.168.2.222 --port=8000

? 提示：--port 可选，默认为 8000；确保该端口未被其他程序占用。启动后终端会显示 Starting Laravel development server: http://192.168.2.222:8000 —— 此 URL 即为其他设备应访问的地址。

✅ 2. 关闭或配置系统防火墙

Windows Defender 防火墙、macOS 防火墙或第三方安全软件可能拦截入站连接。临时验证可先关闭防火墙（仅测试用），生产环境务必添加精确规则：

• Windows：进入「Windows 安全中心 → 防火墙和网络保护 → 允许应用通过防火墙」→ 勾选 php.exe（或手动放行端口 8000 TCP）。
• macOS：「系统设置 → 隐私与安全性 → 防火墙 → 防火墙选项」→ 添加 php 或允许端口。
• Linux（ufw）：

  sudo ufw allow 8000/tcp

✅ 3. 验证与调试技巧

• 在目标 PC 浏览器中直接访问 http://192.168.2.222:8000/api/test（替换为你的真实路由），应返回预期响应；
• 使用 curl 快速测试连通性：

  curl -v http://192.168.2.222:8000/api/version

• 若仍失败，检查：
  • 两台设备是否确实在同一子网（如均为 192.168.2.x）；
  • 路由器是否启用「AP 隔离」（Client Isolation）功能（部分公共 Wi-Fi 会开启，需在路由器后台关闭）；
  • 是否误用 localhost 或 127.0.0.1 替换 IP —— 这些在其他设备上永远无法解析为你本机。

⚠️ 注意事项与进阶建议

• Laravel 的 CORS 限制：即使网络可达，前端跨域请求仍可能被浏览器拦截。若调用方是网页应用，请安装 fruitcake/laravel-cors 并配置允许 * 或指定来源；
• 非 Laravel 项目？ 类似原理适用于任何基于 PHP 内置服务器的框架（如 Slim、Lumen），命令统一为：

  php -S 192.168.2.222:8000 -t public/

• 长期测试推荐：php artisan serve 仅为开发用途，不适用于高并发或稳定外网访问。正式联调建议使用 Laravel Valet（macOS）、Laravel Sail（Docker）或 Nginx + PHP-FPM 组合。

只要正确绑定 IP 并放行端口，局域网 API 调试即可秒级生效——无需改代码、无需部署、无需公网 IP。