PHP内置服务器启动方法及使用教程

PHP内置服务器启动时若未找到默认的router.php文件，会因“Failed to open stream”错误而失败；其实router脚本并非必需，仅在处理非根路径路由时才被自动调用，只需通过`-t`参数显式指定文档根目录（如`php -S localhost:8000 -t public/`）即可绕过加载，或创建一个空的router.php文件快速解决——简单两步，轻松启用PHP原生开发服务器。

php -S 启动失败：找不到 router 脚本或报错 Failed to open stream

PHP 内置服务器启动时，php -S 默认会尝试加载一个 router 脚本（如 router.php），但这个脚本不是必需的——只是当你没显式指定、又用了非根路径（比如访问 /api/user）时，它会自动去找。如果当前目录下没有 router.php，就会报 Failed to open stream: No such file or directory。

解决方法很简单：要么提供一个空的 router.php，要么显式告诉它不用 router：

• 不依赖 router：运行 php -S localhost:8000 -t public/（-t 指定文档根目录，此时 PHP 不会尝试加载 router）
• 需要 router 但不想写逻辑：建一个空的 router.php，内容只写 （返回 false 表示交由内置服务器默认处理静态文件）
• 注意：router.php 必须放在命令执行时的当前工作目录下，不是 -t 指定的目录里

路由不生效：JS/CSS 加载 404 或 POST 接口被当成静态文件

内置服务器对静态资源有默认处理逻辑：当请求路径匹配到 -t 目录下的真实文件（如 public/app.js），就直接返回；否则才交给 router.php。所以如果你把前端构建产物放进了 public/，但后端接口也走 /api/*，而 public/api/ 下恰好有个同名目录或文件，请求就会被截胡。

常见表现是：页面能打开，但 JS 报 404；或者 POST 到 /api/login 返回了 index.html 的 HTML 内容。

• 检查 public/ 目录下是否意外存在与 API 路径同名的子目录或文件（比如 public/api/）
• 在 router.php 中优先拦截 API 请求：用 if (0 === strpos($_SERVER['REQUEST_URI'], '/api/')) { include __DIR__ . '/api_handler.php'; exit; }
• router.php 返回 false 表示“我不处理，请你按默认规则找静态文件”；返回 true 表示“我已处理完毕”，不再继续

Windows 下端口被占用或命令卡住：php -S 没反应

Windows 上经常遇到两种情况：一是端口（比如 8000）被其他进程（Skype、IIS、另一个 PHP 进程）占着；二是终端窗口看似卡住——其实服务已经跑起来了，只是没输出日志，你一敲回车它就跳行，误以为挂了。

• 查端口：运行 netstat -ano | findstr :8000，再用 tasklist | findstr 看是谁占的
• 杀掉占用：用 taskkill /PID /F（需管理员权限）
• 确认服务是否真在跑：浏览器访问 http://localhost:8000，或另开一个终端执行 curl -I http://localhost:8000
• 想看到实时请求日志？加 -d error_log=php://stdout 参数，例如：php -S localhost:8000 -t public/ -d error_log=php://stdout

开发环境能跑，上线就崩：别把 php -S 当生产服务器用

PHP 内置服务器明确标注为「仅用于开发调试」，它单线程、无并发处理能力、不支持 HTTPS、不缓存静态文件、不处理大上传、不支持 .htaccess 重写——这些在本地可能感觉不到，一旦压测或用户变多，立刻暴露。

• 它不解析 .user.ini 或 php.ini 中的某些配置（比如 upload_max_filesize 受限于 CLI SAPI 模式）
• 所有请求都经由同一个 PHP 进程，一个慢请求会阻塞后续全部请求
• 如果你正在用 Laravel/Vue/React 单页应用，记得在 router.php 中 fallback 到 index.html，否则刷新子路由会 404

真正上线前，必须换 Nginx 或 Apache，哪怕只是本地测试反向代理，也要提前验证 rewrite 规则和 MIME 类型是否一致。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。