php脚本在内置服务器下怎么执行-php教程-PHP中文网

php -S 内置服务器必须在脚本根目录执行，仅从当前目录提供服务，访问非 index.php 文件需配合 router.php 路由脚本，否则返回 404 或 “No input file specified.”；端口占用、localhost 解析失败及单线程阻塞是常见问题根源。

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

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 解析。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

最简可用的 router.php：

<?php if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|woff2|ttf)$/', $_SERVER["REQUEST_URI"])) {
    return false; // 静态资源，让内置服务器直接读取并返回
}
return true; // 其他请求交给 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 上首次启动可能弹窗要求“允许接受传入连接”，点“允许”即可，不是杀毒软件拦截