php创建虚拟目录框架集成_Laravel路由映射-php教程-PHP中文网

PHP虚拟目录属Web服务器配置，须指向Laravel的public目录；Laravel路由是框架内PHP逻辑，定义在routes/web.php中，二者分属不同层级且必须协同工作。

php创建虚拟目录框架集成_laravel路由映射

PHP 创建虚拟目录与 Laravel 路由映射是两个不同层级的事：虚拟目录属于 Web 服务器（如 Apache/Nginx）的配置层面，用于将域名或路径指向物理目录；而 Laravel 的路由映射是框架内部的 PHP 逻辑，负责把 HTTP 请求 URI 分发给控制器或闭包。二者需配合，但不能互相替代——尤其关键一点：Web 服务器必须指向 Laravel 项目的 public 目录，否则路由无法正常工作。

这是最容易出错的第一步。Laravel 是单入口框架，所有请求都应经由 public/index.php 进入。若直接把虚拟主机根目录设为项目根目录（如 /var/www/myapp），则 .env、app/、config/ 等敏感目录可能被直接访问，存在安全风险，且路由机制会失效。

Apache 示例（httpd-vhosts.conf）：

<virtualhost><br>    DocumentRoot "/var/www/myapp/public"<br>    ServerName myapp.test<br><directory><br>        AllowOverride All<br>        Require all granted<br></directory><br></virtualhost>

Nginx 示例（server 块内）：

root /var/www/myapp/public;<br>location / {<br>    try_files $uri $uri/ /index.php?$query_string;<br>}

本地 hosts 文件需同步添加：127.0.0.1 myapp.test

Laravel 路由文件决定实际 URL 映射

服务器完成请求转发后，Laravel 才开始处理路由。所有 Web 路由定义在 routes/web.php 中，它只对带 Session、CSRF 保护的常规网页请求生效（API 路由在 routes/api.php，前缀默认为 /api）。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

基础闭包路由：Route::get('/about', function () { return view('about'); });
控制器路由：Route::get('/posts', [PostController::class, 'index']);
带参数路由：Route::get('/user/{id}', [UserController::class, 'show'])->where('id', '\d+');
资源路由（推荐用于 CRUD）：Route::resource('photos', PhotoController::class); 自动生成 7 个标准路由

不要混淆服务器重写与框架路由

有人误以为在 Apache 的 .htaccess 或 Nginx 配置里“加一条 rewrite 规则”就能替代 Laravel 路由，这是误区。服务器重写（如把 /old-page 301 跳转到 /new-page）发生在请求到达 PHP 之前，属于 HTTP 层；而 Laravel 路由是在 PHP 运行时解析 REQUEST_URI 并匹配规则，属于应用层。两者用途不同：

用服务器配置做：域名绑定、HTTPS 强制跳转、静态资源缓存、旧 URL 重定向
用 Laravel 路由做：动态页面分发、中间件注入（如 auth、throttle）、参数验证、命名路由生成 URL

调试技巧：快速验证是否配置正确

如果访问域名返回 404 或显示目录列表，按顺序排查：

确认浏览器地址栏 URL 对应的是你配置的 ServerName（如 myapp.test），不是 localhost/myapp 这类子路径方式
运行 php artisan route:list 查看当前已注册的所有路由，确认目标 URI 是否在列表中
临时在 public/index.php 开头加 die('reached');，看能否执行——若不能，说明请求根本没进 Laravel，问题出在服务器配置
检查 storage/logs/laravel.log 是否有权限错误或解析异常