php内置服务器不自动加载composer.json规则，需手动引入vendor/autoload.php并在router.php中显式处理路由和静态资源；环境变量需用phpdotenv手动加载。
PHP内置服务器不读取composer.json自动加载规则
PHP内置服务器（php -S）本身只是个静态文件+简单路由的HTTP服务，它完全不感知Composer生态。你运行php -S localhost:8000时，不会自动加载vendor/autoload.php，也不会解析autoload配置里的psr-4或classmap规则——类一用就报Class not found。
实操建议：
- 必须手动引入
vendor/autoload.php，最稳妥方式是写一个router.php作为入口路由文件 - 不要指望
index.php里只写业务逻辑；它得先require __DIR__ . '/vendor/autoload.php'; - 如果项目用了
autoload-dev里的测试类，要确认composer dump-autoload已执行（开发模式下默认不生成dev autoload）
路由文件router.php必须显式接管所有请求
PHP内置服务器要求：所有非静态资源请求（比如/api/user）都得由router.php判断是否转发、重写或返回404。它不是“补充路由”，而是唯一路由中枢。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 直接访问
http://localhost:8000/index.php/api能跑，但去掉index.php就404（没配路由文件） - 写了
router.php但忘了return false;给静态文件兜底，导致CSS/JS被当成PHP脚本执行
最小可行示例（router.php）：
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|xml|svg|woff2|ttf)$/', $_SERVER["REQUEST_URI"])) {
return false; // 静态资源交由内置服务器原生处理
}
require __DIR__ . '/vendor/autoload.php';
require __DIR__ . '/index.php'; // 你的主应用入口
composer dump-autoload -o对内置服务器无加速效果
加-o（optimize）生成优化后的autoload_classmap.php，只在生产环境有意义。PHP内置服务器每次请求都是单次执行、无OPcache预热（除非你额外配了opcache.enable_cli=1），所以类加载速度几乎不受-o影响。
反而容易踩的坑：
- 开发中频繁改命名空间或类名，但忘记运行
composer dump-autoload，导致新类不被识别 - 误以为
-o能解决“找不到类”问题，其实根本原因是没引入autoload.php或路由没走对入口 -
autoload-dev下的类（如tests/目录）默认不进主autoload，需单独composer dump-autoload --dev
环境变量和.env文件需要手动加载
像vlucas/phpdotenv这类库不会被PHP内置服务器自动触发。即使你composer require vlucas/phpdotenv了，不显式调用Dotenv\Dotenv::createImmutable()，$_ENV和getenv()仍是空的。
实操建议：
- 在
router.php或index.php最开头加载：$dotenv = Dotenv\Dotenv::createImmutable(__DIR__); $dotenv->load(); - 注意
createImmutable()要求.env在当前目录；若项目结构是public/router.php，路径得写成__DIR__.'/..' - 别依赖
putenv()后立刻读取$_ENV——某些PHP版本需设variables_order = "EGPCS"才生效
return false;——少它一句，静态资源全崩，还查不出原因。 
