PHP 内置服务器（php -S）默认不支持静态资源自动路由，所有请求均被转发至入口脚本，导致 /css/app.css 等路径无法直接访问 —— 解决方案是编写自定义路由文件，优先尝试读取 public/ 下真实文件，未命中时再交由框架路由处理。
php 内置服务器（`php -s`）默认不支持静态资源自动路由，所有请求均被转发至入口脚本，导致 `/css/app.css` 等路径无法直接访问 —— 解决方案是编写自定义路由文件，优先尝试读取 `public/` 下真实文件，未命中时再交由框架路由处理。
在基于 MVC 架构的 PHP 项目中（如你所示的 core/Router.php + public/ 入口结构），静态资源（CSS、JS、图片）无法加载的根本原因并非代码逻辑错误，而是 Web 服务器层缺失对静态文件的直出支持。当你执行 php -S localhost:8080 时，PHP 内置服务器是一个极简的开发用 HTTP 服务，它不具备 Nginx 或 Apache 的文件存在性检查与 MIME 类型自动识别能力：所有请求（包括 /css/style.css）都会无差别地转发给指定的路由脚本（如 index.php），而你的 index.php 并未对静态路径做特殊处理，因此最终触发 Router::abort(404)，返回 404 页面而非实际文件内容。
✅ 正确做法：为内置服务器编写专用路由入口
你需要创建一个位于 public/ 目录下的 built-in.php 文件（名称可自定义），作为 php -S 的实际入口点。该文件承担双重职责：
- 优先检查请求路径是否对应 public/ 下的真实静态文件；
- 若存在，则直接读取并输出，设置正确 Content-Type 头；
- 若不存在，则将请求交由原有 MVC 路由逻辑处理。
以下是推荐的 public/built-in.php 实现（兼容 PHP 8+，安全且健壮）：
<?php
// public/built-in.php
use Core\Router;
// 定义项目根目录（相对于 built-in.php）
define('BASE_PATH', __DIR__ . '/../');
// 获取原始请求 URI（去除查询参数）
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 映射静态资源路径到 public 子目录
$staticPath = __DIR__ . $uri;
// 白名单扩展名（防止目录遍历攻击）
$allowedExtensions = [
'.css' => 'text/css',
'.js' => 'application/javascript',
'.png' => 'image/png',
'.jpg' => 'image/jpeg',
'.jpeg' => 'image/jpeg',
'.gif' => 'image/gif',
'.svg' => 'image/svg+xml',
'.woff2' => 'font/woff2',
'.ttf' => 'font/ttf',
];
// 检查是否为合法静态文件请求
if (file_exists($staticPath) && is_file($staticPath)) {
$ext = strtolower(pathinfo($staticPath, PATHINFO_EXTENSION));
if (isset($allowedExtensions[$ext])) {
header('Content-Type: ' . $allowedExtensions[$ext]);
header('Cache-Control: public, max-age=31536000'); // 长缓存
readfile($staticPath);
exit;
}
}
// 否则交由 MVC 路由处理（复用原 index.php 逻辑）
session_start();
require BASE_PATH . 'vendor/autoload.php';
require BASE_PATH . 'Core/functions.php';
require BASE_PATH . 'bootstrap.php';
$router = new Router();
require BASE_PATH . 'routes.php';
$method = $_POST['_method'] ?? $_SERVER['REQUEST_METHOD'];
try {
$router->route($uri, $method);
} catch (Exception $e) {
http_response_code(500);
echo $e->getMessage();
}? 启动命令更新
将启动命令从：
立即学习“PHP免费学习笔记（深入）”；
php -S localhost:8080
改为：
php -S localhost:8080 -t public public/built-in.php
⚠️ 注意：-t public 显式指定文档根目录为 public/，public/built-in.php 是路由入口脚本。此组合确保所有请求先经 built-in.php 分流。
? 关键注意事项
- 绝对禁止路径穿越：built-in.php 中使用 __DIR__ . $uri 并配合扩展名白名单，有效防御 ../../etc/passwd 类攻击；
- HTML 中路径必须为根相对路径：在视图模板中引用静态资源时，务必使用以 / 开头的路径，例如 <link href="/css/app.css">，而非 ./css/app.css 或 css/app.css —— 这样才能与 php -S 的 URI 解析保持一致；
- 生产环境切勿使用内置服务器：php -S 仅适用于开发调试，无并发处理、无 HTTPS、无 gzip 压缩等能力。上线前务必迁移到 Nginx + PHP-FPM 或 Apache；
- Nginx/Apache 配置更简单：若切换至 Nginx，只需在 server 块中配置 root /path/to/your/project/public; 和 try_files $uri $uri/ /index.php?$query_string; 即可全自动分流；Apache 则需启用 mod_rewrite 并确保 .htaccess 生效。
✅ 验证是否生效
启动服务后，在浏览器访问：
- http://localhost:8080/css/app.css → 应返回 CSS 内容且状态码为 200；
- http://localhost:8080/ → 应正常渲染首页（触发路由）；
- http://localhost:8080/nonexistent.js → 应返回 404 页面（由 Router::abort() 处理）。
至此，你的 MVC 项目在开发阶段即可获得与生产环境一致的静态资源服务能力，无需修改任何业务逻辑或路由规则。
