如何彻底移除 Laravel 项目 URL 中的 /public 路径-php教程-PHP中文网

如何彻底移除 Laravel 项目 URL 中的 /public 路径

本文详解在无法修改 Web 服务器配置（如共享主机）时，通过正确配置 .htaccess 实现 URL 隐藏 /public 的安全方案，并确保 CSS/JS/Livewire 等静态资源与路由正常加载。核心在于让服务器实际以 public/ 为文档根目录，而非依赖重写规则“模拟”根目录。

本文详解在无法修改 web 服务器配置（如共享主机）时，通过正确配置 `.htaccess` 实现 url 隐藏 `/public` 的安全方案，并确保 css/js/livewire 等静态资源与路由正常加载。核心在于让服务器实际以 `public/` 为文档根目录，而非依赖重写规则“模拟”根目录。

在 Laravel 项目中，访问 URL 出现 /public/（例如 https://example.com/public/css/app.css 或 https://example.com/public/login），根本原因并非 Laravel 本身的问题，而是 Web 服务器的文档根目录（Document Root）被错误地指向了项目根目录（如 public_html/），而非其下的 public/ 子目录。你当前使用的 .htaccess 规则（将请求重写至 public/$1）看似隐藏了路径，实则制造了严重隐患：它让所有请求先经过项目根目录再转发，导致资源路径错乱、Livewire WebSocket 失败、CSRF Token 异常，且存在潜在的安全风险（如 .env 文件可能被意外暴露）。

✅ 正确且安全的解决方案是：确保托管环境的域名或子目录实际解析到 public/ 目录 —— 这是 Laravel 官方唯一推荐的部署方式。

✅ 共享主机环境下的标准操作流程（无需服务器权限）

以常见共享主机（cPanel、Plesk 或类似面板）为例：

上传项目结构保持原样
将完整 Laravel 项目（含 app/、bootstrap/、config/、public/、vendor/ 等）上传至服务器，例如放在 public_html/myapp/ 目录下。
在控制面板中修改域名根目录
- 登录主机控制面板（如 cPanel → “Addon Domains” 或 “Subdomains”）；
- 找到对应域名（如 myapp.example.com）或子目录绑定设置；
- 将 Document Root（根目录）从 public_html/myapp 修改为 public_html/myapp/public；
- 保存并等待 DNS/缓存生效（通常立即生效）。
确认 public/.htaccess 使用 Laravel 默认规则
public/ 目录下必须存在且启用以下标准 .htaccess（Laravel 8+ 自带）：

<ifmodule mod_rewrite.c><ifmodule mod_negotiation.c>
        Options -MultiViews -Indexes
    </ifmodule>

    RewriteEngine On

    # 处理 Authorization Header（用于 API 认证）
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # 强制重写所有非真实文件/目录的请求至 index.php（前端控制器）
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</ifmodule>

⚠️ 注意：不要在项目根目录（myapp/）放置任何 .htaccess 文件。根目录的 .htaccess 在共享主机上不仅无效，还可能干扰路由或引发 500 错误。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

❌ 为什么你当前的 `.htaccess` 方案失败？

你提供的规则：

RewriteRule ^(.*)$ public/$1
RewriteRule ^ server.php

存在两个致命问题：

它把请求“代理”进 public/，但 PHP 执行时仍以项目根目录为 __DIR__，导致 public_path() 返回 /path/to/myapp/public，而 asset() 生成的 URL 却基于错误的根上下文，造成 CSS/JS 路径变成 /public/css/app.css（双重 public）；
server.php 是 Laravel 的开发用入口，生产环境严禁使用，它不支持重写、无缓存优化、不兼容 Livewire 的长连接与 Vite HMR。

✅ 验证是否成功

部署后访问：

✅ https://myapp.example.com/login → 应正常显示登录页（无 /public）；
✅ 浏览器开发者工具 Network 标签中，/css/app.css、/js/app.js、/livewire/livewire.js 均返回 200，路径不含 /public/；
✅ Blade 中使用 {{ asset('css/app.css') }} 生成的链接为 /css/app.css（非 /public/css/app.css）。

? 安全提醒（重要！）

切勿将 index.php 或 .htaccess 移至项目根目录并修改路径（如 require __dir__.'/bootstrap/app.php'）——这会暴露 app/、config/、.env 等敏感目录，一旦 Apache 模块异常或 .htaccess 失效，极易导致源码泄露；
切勿将静态资源（CSS/JS）硬编码加 /public/ 前缀——违反 Laravel 资源管理规范，破坏 mix()、Vite::useIntegrityKey() 等功能；
生产环境始终使用 php artisan serve 仅限本地调试，永远不要用于线上服务。