phpEnv本地手机访问配置教程

本文详细讲解了如何让手机通过局域网访问本地运行的phpEnv环境，直击“手机打不开”这一高频痛点：从修改Apache监听IP、配置Windows防火墙放行80端口、完善虚拟主机权限（Require all granted），到解决Android 9+因明文限制导致的ERR_CLEARTEXT_NOT_PERMITTED错误（需精准配置network_security_config.xml白名单），每一步都覆盖真实调试中极易忽略的关键细节和常见陷阱，助你快速打通本地开发与移动端联调的最后一公里。

phpEnv 启动后手机打不开，先确认服务是否监听局域网 IP

phpEnv 默认只绑定 127.0.0.1，这意味着它拒绝来自手机（同一 Wi-Fi 下的另一台设备）的连接。你必须手动修改 Apache 配置，让它监听本机真实 IPv4 地址。

操作步骤：

• 在 Windows 上运行 ipconfig，找到「无线局域网适配器 WLAN」下的 IPv4 地址（如 192.168.1.105）
• 打开 phpEnv 安装目录 → Apache\conf\httpd.conf
• 搜索 Listen 80，改为 Listen 192.168.1.105:80（替换成你自己的 IP）
• 搜索 ServerName localhost:80，改为 ServerName 192.168.1.105:80
• 重启 phpEnv 的 Apache 服务

改完后，在手机浏览器直接访问 http://192.168.1.105。如果页面加载成功，说明服务已对外暴露；若失败，大概率是防火墙或虚拟主机配置未放行。

Android 手机访问报 ERR_CLEARTEXT_NOT_PERMITTED，必须配 network_security_config.xml

Android 9（API 28）起默认禁止明文 HTTP 请求，仅加 android:usesCleartextTraffic="true" 在 AndroidManifest.xml 中已不可靠——尤其在 Android 10+ 上常被系统忽略。

正确做法是创建精准域名白名单：

• 在 app/src/main/res/xml/ 下新建 network_security_config.xml
• 内容必须包含你实际使用的局域网 IP，例如：

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config>
    <domain-config>
      <domain includeSubdomains="true">192.168.1.105</domain>
      <cleartextTrafficPermitted>true</cleartextTrafficPermitted>
    </domain-config>
  </network-security-config>

• 在 AndroidManifest.xml 的 标签中添加：android:networkSecurityConfig="@xml/network_security_config"

⚠️ 注意： 和 不能共存；只要用了 ，就必须把目标 IP 明确写进 ，漏掉一个字符都会导致配置失效。

手机能 ping 通但无法加载页面，检查 Windows 防火墙入站规则

即使 Apache 绑定了正确 IP、Android 配置也无误，Windows 防火墙仍可能拦截 80 端口的入站连接。这是最常被忽略的一环。

验证和修复方法：

• 在手机终端执行：ping 192.168.1.105 —— 若不通，先查网络是否同属一个 Wi-Fi
• 在 Windows 上打开「Windows Defender 防火墙」→「高级设置」→「入站规则」
• 新建规则 →「端口」→ TCP → 特定本地端口 80 → 允许连接 → 勾选「域」「专用」「公用」→ 规则名称填 phpEnv-HTTP
• 重启 Apache，再试手机访问

如果你改过端口（比如用 8080），那规则里也要对应改成 8080；不要试图关闭整个防火墙，这既不安全也不必要。

phpEnv 虚拟主机配置需显式放开 Require all granted

如果你在 phpEnv 中启用了虚拟主机（vhost），默认配置往往只允许 localhost 访问，手机请求会被 Apache 直接拒之门外。

检查你的 httpd-vhosts.conf（通常在 Apache/conf/extra/ 下），确保每个 内的 区块包含明确放行指令：

<Directory "D:/www/myproject">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

注意：Require all granted 是 Apache 2.4+ 的语法；如果是旧版 Apache 2.2，要用 Order allow,deny + Allow from all。phpEnv 多数基于 2.4，别混用。

改完务必重启 Apache，否则配置不生效。很多调试卡在这一步，却反复检查代码或网络，其实只是少了一行权限声明。

好了，本文到此结束，带大家了解了《phpEnv本地手机访问配置教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！