解决Laravel项目在共享主机（如000webhost）上链接失效的404问题-php教程-PHP中文网

解决Laravel项目在共享主机（如000webhost）上链接失效的404问题

花韻仙語

发布： 2025-07-02 22:02:28

原创

470人浏览过

解决laravel项目在共享主机（如000webhost）上链接失效的404问题

本教程详细阐述了在将Laravel应用部署到共享主机（如000webhost）时，链接失效并出现404错误的原因及解决方案。核心在于通过配置.htaccess文件，确保服务器正确处理URL重写，将所有请求路由至Laravel的入口文件index.php，从而恢复应用的正常路由功能。

问题背景：Laravel应用在共享主机上的路由挑战

当您在本地开发环境中运行Laravel应用时，所有路由通常都能正常工作。然而，一旦将项目部署到共享主机（例如000webhost）上，您可能会遇到所有链接都返回“Page Not Found - Error 404”的问题，尽管首页可能可以正常访问。这通常不是代码逻辑错误，而是服务器环境配置不当，未能正确处理Laravel的URL重写机制所致。

Laravel框架采用“单一入口”模式，所有请求都应通过public/index.php文件进行处理。这意味着，无论用户访问哪个URL路径，Web服务器（如Apache）都需要将这些请求内部重写到index.php，然后由Laravel的路由系统来解析并分发请求。在Apache服务器上，这一重写功能主要依赖于mod_rewrite模块和.htaccess文件。如果服务器没有启用mod_rewrite模块，或者.htaccess文件配置不正确或缺失，服务器就无法将请求正确导向index.php，从而导致404错误。

核心解决方案：配置.htaccess文件

解决Laravel在共享主机上链接失效问题的关键在于在网站的根目录（通常是public_html）中创建一个正确的.htaccess文件。这个文件会告诉Apache服务器如何处理传入的URL请求，确保它们被Laravel的index.php入口文件捕获。

以下是用于解决此问题的标准.htaccess文件内容：

百度虚拟主播

百度智能云平台的一站式、灵活化的虚拟主播直播解决方案

查看详情

<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
    Options -MultiViews
</IfModule>

RewriteEngine On

# Redirect Trailing Slashes If Not A Folder...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ /$1 [L,R=301]

# Handle Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

# Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
</IfModule>

登录后复制

如何操作：

在您的Laravel项目部署到的网站根目录（例如，000webhost上的public_html文件夹）中，创建一个名为.htaccess的新文件。
将上述代码复制并粘贴到新创建的.htaccess文件中。
保存文件。

.htaccess文件内容解析

让我们逐行解析这个.htaccess文件的作用：

<IfModule mod_rewrite.c> 和 </IfModule>: 这对标签确保了只有当Apache的mod_rewrite模块被加载时，内部的规则才会生效。这是一个良好的实践，可以避免在不支持mod_rewrite的环境中引发服务器错误。
<IfModule mod_negotiation.c> 和 Options -MultiViews: MultiViews是一个Apache选项，它允许服务器在找不到精确匹配的文件时，尝试通过内容协商来查找文件。对于Laravel这样的框架，它可能会干扰URL重写，导致意外的行为。Options -MultiViews禁用了此功能，确保URL重写规则能够按预期工作。
RewriteEngine On: 这是启用Apache重写引擎的指令。没有它，下面的所有重写规则都不会生效。
# Redirect Trailing Slashes If Not A Folder...:
- RewriteCond %{REQUEST_FILENAME} !-d: 这是一个条件，表示如果请求的URI不是一个存在的目录。
- RewriteRule ^(.*)/$ /$1 [L,R=301]: 如果URI以斜杠结尾且不是一个目录，则移除末尾的斜杠并进行301永久重定向。这有助于规范URL格式，避免重复内容。
# Handle Front Controller...: 这是将所有请求导向Laravel index.php的核心规则。
- RewriteCond %{REQUEST_FILENAME} !-d: 条件一，如果请求的URI不是一个存在的目录。
- RewriteCond %{REQUEST_FILENAME} !-f: 条件二，如果请求的URI不是一个存在的文件。
- RewriteRule ^ index.php [L]: 如果以上两个条件都满足（即请求的URI既不是一个文件也不是一个目录），那么将请求内部重写到index.php。[L]标志表示这是最后一条规则，停止进一步的重写处理。
# Handle Authorization Header:
- RewriteCond %{HTTP:Authorization} .: 检查HTTP请求头中是否存在Authorization字段。
- RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]: 如果存在Authorization头，将其值设置到一个名为HTTP_AUTHORIZATION的环境变量中。这对于处理API请求中的认证信息（如Bearer Token）至关重要，确保Laravel能够正确接收和解析。

注意事项

服务器环境要求： 确保您的共享主机（如000webhost）支持Apache服务器，并且已启用mod_rewrite模块。大多数现代共享主机都会默认启用。
文件放置准确性： .htaccess文件必须放置在您网站的根目录中，通常是public_html。如果您的Laravel项目结构是：public_html/your_laravel_project/public/，那么您可能需要将.htaccess文件放置在public_html/your_laravel_project/public/目录下，或者将Laravel public目录下的所有内容直接移动到public_html中，并将.htaccess文件放在public_html中。本教程的解决方案假设您已将Laravel的public目录内容直接部署到了public_html。
Laravel项目结构： 确保您的Laravel项目中的public文件夹内的所有内容（包括index.php、.htaccess等）都已正确地复制到了服务器的网站根目录（例如public_html）。
缓存问题： 在修改.htaccess文件后，建议清除浏览器缓存，有时服务器端也可能存在缓存，可能需要等待一段时间或联系主机提供商清除。
权限问题： 确保.htaccess文件具有正确的读取权限（通常是644），以便Web服务器能够访问和解析它。

总结

通过在共享主机环境的网站根目录中正确配置.htaccess文件，可以有效地解决Laravel应用部署后链接失效的404问题。这个文件是Apache服务器上Laravel应用正常运行的关键，它确保了所有非文件、非目录的请求都能被正确地重定向到Laravel的index.php入口文件，从而激活框架的路由系统。理解并正确应用这些配置，是成功部署Laravel应用到共享主机的重要一步。

以上就是解决Laravel项目在共享主机（如000webhost）上链接失效的404问题的详细内容，更多请关注php中文网其它相关文章！