php -s 启动失败因默认查找 router.php 但未找到；解决方法为：①用 -t 指定根目录避免加载 router，②创建空 router.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，内容只写<?php return false;（返回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 内容。
小兵小兵建站CMS V1.0(内容管理系统)，基于OneThink开源框架，和超过300家以上网站建设客户进行了深度的合作与需求沟通，经过了一年时间的研发，打造了国内最简洁好用、易于操作的网站管理后台。小兵建站CMS，国内最简单易用的网站管理系统！永久免费开源！小兵建站CMS服务器配置要求：安装环境：PHP 版本 5.3以上 ； mysql: 5.0以上 IIS： 7.0 以上 安装
立即学习“PHP免费学习笔记（深入）”；
- 检查
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 <pid></pid>看是谁占的 - 杀掉占用：用
taskkill /PID <pid> /F</pid>（需管理员权限） - 确认服务是否真在跑：浏览器访问
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 类型是否一致。
