composer不参与虚拟主机路径配置，web服务器documentroot必须指向项目public/等明确入口目录，而非项目根目录，否则将导致安全风险与解析错误。
Composer 本身不提供、也不参与虚拟主机（Virtual Host）路径配置。它不解析 Apache/Nginx 的 vhost 配置，不修改 DocumentRoot，也不生成或重写 Web 服务器的路由规则。所谓“Composer 虚拟主机项目路径”，实际是开发者把 Composer 项目目录错误地当成了 Web 入口目录来配置，导致 404、空白页或敏感文件暴露。
为什么在 Apache/Nginx 里直接指向项目根目录会出问题
Composer 项目的根目录（含 composer.json）通常包含 vendor/、tests/、src/ 等非公开目录，而 Web 服务器必须只暴露 public/（Laravel）、web/（Symfony）或 htdocs/（自定义）这类明确的 Web 入口。直接把 DocumentRoot 指向项目根目录会导致：
-
vendor/目录被直接访问，可能泄露依赖结构甚至composer.lock中的包版本 -
.env或config/下的配置文件被下载（若未禁用） - PHP 解析失败：Web 服务器尝试执行
composer.json这类纯 JSON 文件，返回源码或 500 错误
正确设置 Web 入口路径的三步操作
以 Laravel 为例（其他框架逻辑一致，仅入口目录名不同）：
- 确认框架约定的 Web 入口目录：Laravel 是
public/，Symfony 是public/，CodeIgniter 4 是public/，ThinkPHP 是public/—— 不是项目根目录 - Apache 配置中，
DocumentRoot必须指向/path/to/your-project/public，不是/path/to/your-project - Nginx 配置中，
root指令必须设为/path/to/your-project/public；同时确保index index.php和try_files $uri $uri/ /index.php?$query_string存在 - 若用 PHP 内置服务器测试：运行
php -S localhost:8000 -t public/ router.php（-t public/明确指定 Web 根）
常见错误：试图用 Composer 命令改 DocumentRoot
有人尝试在 composer.json 里加 "config": {"web-dir": "public"} 或运行 composer config web-dir public —— 这些字段完全无效。Composer 不读取、不处理、不生成任何 Web 服务器配置。以下行为均无意义：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目
composer.json中添加web-dir、document-root、public-dir等自定义键 - 执行
composer config --global web-dir public（全局配置更不会影响 Web 服务） - 期望
composer install自动创建或修改httpd.conf或nginx.conf
这些操作不会报错，但也不会产生任何 Web 服务器效果——因为 Composer 根本不碰它们。
真正需要协同配置的两个位置
Web 服务器路径生效，靠的是两处独立配置的对齐：
-
代码侧：框架自身的入口文件（如
public/index.php）必须能正确加载vendor/autoload.php。该路径通常是相对的：require __DIR__.'/../vendor/autoload.php';—— 所以public/必须在项目根目录下一级，不能挪走 -
运维侧：Apache/Nginx 的
DocumentRoot或root必须精确匹配这个public/的绝对路径。路径错一位、少一个/、大小写不符（尤其 Windows），都会导致 403/404
最容易被忽略的是：本地开发用 XAMPP/WAMP 时，htdocs 是默认 Web 根，你得把整个项目（含 public/）放进去，再通过 http://localhost/my-project/public/ 访问 —— 正确做法是把 my-project/public/ 的内容整体复制进 htdocs/my-project/，而不是把整个项目扔进去。
