composer如何在PHP内置服务器中配合使用？（开发调试一体化）

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了，不显式调用DotenvDotenv::createImmutable()，$_ENV和getenv()仍是空的。

实操建议：

• 在router.php或index.php最开头加载：$dotenv = DotenvDotenv::createImmutable(__DIR__); $dotenv->load();
• 注意createImmutable()要求.env在当前目录；若项目结构是public/router.php，路径得写成__DIR__.'/..'
• 别依赖putenv()后立刻读取$_ENV——某些PHP版本需设variables_order = "EGPCS"才生效

实际调试时最容易被忽略的，是路由文件里那句return false;——少它一句，静态资源全崩，还查不出原因。