如何在共享主机上将 Laravel 项目的根目录正确指向 public 文件夹-php教程-PHP中文网

如何在共享主机上将 Laravel 项目的根目录正确指向 public 文件夹

本文详解如何通过 .htaccess 规则将 Laravel 应用的 Web 根目录从默认主目录（如 example.com/）安全、正确地重定向至 public/ 子目录，解决 CSS、JS、图片等静态资源路径错误（如 example.com/public/app.css）问题。

本文详解如何通过 `.htaccess` 规则将 laravel 应用的 web 根目录从默认主目录（如 `example.com/`）安全、正确地重定向至 `public/` 子目录，解决 css、js、图片等静态资源路径错误（如 `example.com/public/app.css`）问题。

在共享主机环境中，多数服务商不允许修改服务器的 DocumentRoot（网站根目录），因此无法像 VPS 那样直接将站点根目录指向 Laravel 的 public/ 目录。此时，必须借助 Apache 的 .htaccess 文件实现请求路径的透明重写，使所有访问（包括静态资源）均被正确路由到 public/ 下，同时对外保持干净的 URL（如 example.com/app.css 而非 example.com/public/app.css）。

✅ 正确的 .htaccess 配置方案

请替换您当前根目录下的 .htaccess 文件内容为以下经过验证的配置（适用于 Laravel 9+ 及主流共享主机环境）：

# 启用重写引擎
RewriteEngine On

# 确保请求不重复进入 public/（防止循环重写）
RewriteCond %{REQUEST_URI} !^/public/
# 将所有请求隐式转发至 public/ 目录下
RewriteRule ^(.*)$ public/$1 [L]

# 以下为 Laravel 原生 public/.htaccess 的核心逻辑（可选但推荐保留）
<ifmodule mod_rewrite.c><ifmodule mod_negotiation.c>
        Options -Indexes
    </ifmodule>

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

    # 移除末尾斜杠（非目录时）
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # 所有非真实文件/目录的请求交由 public/index.php 处理
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L]
</ifmodule>

⚠️ 关键说明：

Laravel 13.2.0
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

第一组 RewriteRule ^(.*)$ public/$1 [L] 是核心——它让 Apache 在内部将 example.com/app.css 映射为 example.com/public/app.css，用户浏览器地址栏不会显示 /public/；

后续块应保留在 public/.htaccess 中（而非根目录），但此处将其合并进根 .htaccess 是为了兼容无子目录权限的主机；

RewriteCond %{REQUEST_URI} !^/public/ 防止对已含 /public/ 的请求二次重写，避免 500 错误或重定向循环。