phpstorm内置服务器默认监听127.0.0.1，小程序无法访问；必须改用命令php -s 0.0.0.0:8000 -t public/启动，绑定局域网ip，并在小程序后台配置对应https域名（如内网穿透地址），同时确保防火墙放行端口、xdebug client_host指向正确宿主机ip。
微信小程序后端用 PHP 写，本地跑在 PhpStorm 里，但小程序真机或开发者工具根本连不上 localhost 或 127.0.0.1 ——这不是配置错了，是微信的网络策略直接拦死。必须让后端服务暴露在局域网可访问地址，并绕过「不允许与本机 IP 通信」这条限制。
PhpStorm 内置服务器怎么启动才让小程序能访问
PhpStorm 的 PHP Built-in Web Server 默认只监听 127.0.0.1，小程序真机、模拟器、甚至同局域网其他设备都连不上。关键不是“能不能跑”，而是“监听谁”。
- 不要点绿色三角直接运行 —— 那只会绑定
localhost:8000，小程序请求必然失败 - 手动启动命令行：打开终端，cd 到项目根目录，执行
php -S 0.0.0.0:8000 -t public/（public/替换为你实际的 Web 入口目录） -
0.0.0.0表示监听所有网卡，局域网内其他设备（包括手机）就能用你电脑的局域网 IP（如192.168.1.105:8000）访问 - 确保 Windows/macOS 防火墙放行该端口；路由器不用动，纯局域网通信不涉及 NAT
为什么小程序连不上 192.168.x.x，却能连上内网穿透地址
微信明确禁止小程序向 127.0.0.1、localhost 发起请求，但对「局域网 IP」是条件放开的：基础库 ≥ 2.4.0 才允许，且仅限 IPv4 局域网地址（192.168.x.x、10.x.x.x、172.16–31.x.x），但部分安卓机型或旧版微信仍会拦截 —— 这就是为什么有时填了 http://192.168.1.105:8000 在开发者工具里能通，真机却 404 或超时。
- 内网穿透（如 ngrok、cpolar、花生壳）生成的
https://xxx.ngrok.io地址，本质是公网域名 + HTTPS，完全符合小程序「必须配 HTTPS 域名」的要求 - 它绕过了局域网 IP 的兼容性坑，也避开了「本机 IP 不允许」的硬性限制
- 注意：穿透服务必须支持自定义子域名或固定 URL，否则每次重启隧道地址变，还得反复改小程序后台的「服务器域名」配置
PhpStorm 调试断点进不去？Xdebug 配置三处必改
即使 PHP 接口能被小程序访问，Xdebug 断点也常失效 —— 根本原因不是插件没装，而是 Xdebug 3 的默认行为和 PhpStorm 监听机制不匹配。
-
xdebug.mode=debug（不是remote_enable=1，Xdebug 3 已废弃该参数） -
xdebug.client_host=192.168.1.1（填你路由器网关地址，不是localhost；Docker 容器内则填宿主机 IP） -
xdebug.client_port=9003（Xdebug 3 默认端口，PhpStorm 的Settings > PHP > Debug里也要设成 9003，且勾选Start Listening for PHP Debug Connections） - 小程序请求带
?XDEBUG_SESSION_START=PHPSTORM参数才能触发调试；用浏览器插件 Xdebug Helper 或手动加更可靠
小程序后台「服务器域名」怎么填才不踩坑
填错一个字符，wx.request 就直接 fail，错误信息只显示「request:fail network error」，毫无提示。
- 必须是完整 HTTPS 域名，不能带路径，例如填
https://api.example.com，就不能写https://api.example.com/v1 - 如果用了内网穿透地址（如
https://abc.cpolar.io），必须在小程序管理后台「开发设置 → 服务器域名」里精确填写这个域名，且已备案（个人主体可用「微信云托管」免配域名） - 端口不能显式写：填了
https://api.example.com:8000，就只能请求这个端口；但小程序不支持非标准 HTTPS 端口（即非 443），所以穿透服务必须用 443 映射，不能用 8000 - 真机调试时，别信开发者工具里的「预览」按钮 —— 它走的是工具进程代理，和真机网络环境不同，务必用手机扫码实测
最易忽略的一点：Xdebug 的 client_host 值取决于你的网络拓扑 —— 是直连 WiFi？走公司代理？用 Docker？不同场景下这个 IP 可能是网关、宿主机、或虚拟网卡地址，填错就收不到调试连接，日志里也不会报错，只会静默失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
