php脚本在内置服务器下怎么执行

用PHP内置服务器调试时，最让人头疼的莫过于浏览器里一片空白，返回一句“No input file specified.”。这到底是为什么？我看到的项目中，至少有一半人第一次用php -S时都卡在同一个地方——不是代码写错了，而是对内置服务器的运行机制理解不深。下面这几个要点，基本能帮你解决90%的启动问题。

php -S 命令必须在脚本所在目录执行

内置服务器不会自动递归查找文件，它只从当前工作目录开始提供服务。如果你在其他路径下运行 php -S localhost:8000，即使目标 PHP 文件在子目录里，浏览器访问 http://localhost:8000/sub/f.php 也会报 404。这不是文件不存在，而是服务器根本没加载那个路径下的内容。

常见的错误现象：Warning: Unknown: failed to open stream: No such file or directory 或直接返回 “No input file specified.”。

• 先用 cd 切到含 PHP 文件的最上层目录（比如你有 index.php 和 api/user.php，就 cd 进这个根目录）
• 不要加路径参数：错误写法是 php -S localhost:8000 ./api/router.php；正确写法是 php -S localhost:8000 router.php，且 router.php 必须在当前目录
• 如果项目结构复杂、路由分散，建议把 router.php 放在根目录，并用 file_exists(__DIR__ . '/' . $request) 手动映射请求路径

router.php 不是可选配件，而是处理非 index.php 请求的必需逻辑

默认情况下，php -S 只会尝试加载 index.php。访问 http://localhost:8000/test.php 却没反应？不是端口问题，也不是文件权限问题，而是服务器压根没转发请求给该文件——它只认 index.php，除非你显式提供路由脚本。

router.php 的核心职责是返回 true（让服务器继续处理请求）或 false（由脚本自己输出响应），并决定是否静态返回或交由 PHP 解析。

• 最简可用的 router.php：

不写 router.php 就只能跑 index.php；写了但没 return true，所有 PHP 脚本都会被当成静态文件返回源码（极其危险）
别在 router.php 里用 include 或 require 直接加载目标脚本——这会导致 $_SERVER 等超全局变量丢失上下文

端口被占用或无法访问 localhost 的真实原因往往不是防火墙

运行 php -S localhost:8000 后浏览器打不开，第一反应常是“是不是防火墙拦了”？其实更大概率是：端口已被占用，或 localhost 解析失败。

• 检查端口是否空闲：lsof -i :8000（macOS/Linux）或 netstat -ano | findstr :8000（Windows），杀掉对应 PID
• 换用 127.0.0.1:8000 替代 localhost:8000：某些系统 hosts 文件异常或 DNS 缓存会让 localhost 解析失败
• Windows 上若提示“拒绝访问”，不是权限问题，而是你用了 PowerShell 并启用了执行策略限制——改用 CMD 或运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• Mac 上首次启动可能弹窗要求“允许接受传入连接”，点“允许”即可，不是杀毒软件拦截

内置服务器不支持并发，但调试时容易误判为脚本卡死

当你在浏览器里快速连发多个请求（比如刷新页面 + 点击 AJAX 按钮 + 打开新标签页访问同一接口），会发现第二个请求一直 pending，直到第一个完成。这不是你的代码有死循环，是内置服务器天生单线程阻塞模型。

• 这种行为在开发阶段几乎无感，但一旦你在 router.php 里做了耗时操作（如 sleep(5)），就会立刻暴露出来
• 不要用它测试长轮询、WebSocket 或任何依赖并发响应的逻辑
• 如果需要模拟并发行为，得靠外部工具（如 ab 或 curl -s & 多次发起），而不是靠浏览器多开标签

实际执行一个脚本，最稳的三步就是：进对目录 → 写好 router.php（哪怕只有一行 return true;）→ 用 127.0.0.1:8000/xxx.php 访问。其余所有“不行”的情况，基本都卡在这三个环节的某个细节上。