php内置服务器不走composer autoload,因为php -s是纯http服务器,不自动加载vendor/autoload.php;需在router.php首行显式require,路径须正确(如__dir__.'/../vendor/autoload.php'),否则类无法解析。

PHP内置服务器不走composer autoload,为什么?
因为 php -S 启动的是纯HTTP服务器,它只按路由规则转发请求,完全不加载 vendor/autoload.php —— 你写的 use App\Class 在入口文件里会直接报 Class not found,哪怕 composer dump-autoload 过也没用。
用 -t public + router.php 引导时,autoload 怎么生效?
关键在 router 文件:它必须在任何业务逻辑执行前,显式引入自动加载器。否则路由匹配成功、脚本开始执行,但类还没注册。
- router.php 开头第一行就得是
require __DIR__ . '/vendor/autoload.php'; - 不能写在条件分支里(比如只在
if ($path === '/api')下 require) - 不能依赖框架的引导逻辑(如 Laravel 的
index.php已包含 autoload,但你若另写 router 就得自己补)
示例最小可行 router.php:
<?php
require __DIR__ . '/vendor/autoload.php';
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|xml|woff2|ttf)$/', $_SERVER['REQUEST_URI'])) {
return false;
}
require __DIR__ . '/public/index.php';
为什么有时候加了 autoload 还报错?常见漏点
不是没引,而是引错了路径,或者引早了/引晚了。
立即学习“PHP免费学习笔记(深入)”;
-
__DIR__指向 router.php 所在目录,如果 router 放在public/下,__DIR__ . '/vendor/autoload.php'就会找public/vendor/autoload.php—— 显然不存在 - 用
dirname(__DIR__)或__DIR__ . '/../vendor/autoload.php'才对(假设 vendor 在项目根) - 某些 IDE 或构建工具会把 vendor 复制进 public,但 composer 默认不这么干,别凭感觉猜路径
- 如果项目用了 classmap 或 psr-4 配置但没运行
composer dump-autoload --optimize,某些动态加载场景(如反射)可能失败,不过基础 new 实例通常不受影响
生产环境 autoload 和本地 php -S 行为一致吗?
行为可以一致,但前提是 Web 服务器(Nginx/Apache)的入口文件也显式 require 了 autoload —— Laravel、Symfony 默认都这么做,所以没问题;但如果你手写 index.php 却忘了这句,生产也会报错,不只本地。
真正容易被忽略的是:router.php 是 PHP 内置服务器的“唯一钩子”,它既管静态资源判断,又承担初始化职责。少一个 require,整个 autoloading 就断在起点,后面所有依赖注入、控制器解析全崩。











