解決 Laravel 項(xiàng)目在共享主機(jī)上鏈接失效的 404 錯(cuò)誤

2111

解決 Laravel 項(xiàng)目在共享主機(jī)上鏈接失效的 404 錯(cuò)誤

本教程旨在解決 laravel 項(xiàng)目部署到共享主機(jī)（如 000webhost）后，內(nèi)部鏈接出現(xiàn) 404 錯(cuò)誤的問題。核心解決方案是通過在網(wǎng)站根目錄配置 .htaccess 文件，確保服務(wù)器正確重寫 URL 并將所有請(qǐng)求導(dǎo)向 Laravel 的 index.php 前端控制器，從而恢復(fù)路由功能。

理解 Laravel 路由與共享主機(jī)環(huán)境的挑戰(zhàn)

Laravel 框架采用“前端控制器”模式，這意味著所有 http 請(qǐng)求都應(yīng)通過位于項(xiàng)目 public 目錄下的 index.php 文件進(jìn)行處理。index.php 負(fù)責(zé)加載框架核心，解析請(qǐng)求的 URL，并將其路由到相應(yīng)的控制器或閉包函數(shù)。在本地開發(fā)環(huán)境中，通常由 PHP 內(nèi)置服務(wù)器、nginx 或 apache 配置來確保所有請(qǐng)求都正確地重定向到 index.php。

然而，當(dāng) Laravel 項(xiàng)目部署到某些共享主機(jī)環(huán)境時(shí)，服務(wù)器的默認(rèn)配置可能無法識(shí)別這種重寫規(guī)則，導(dǎo)致除了根 URL (/) 之外的所有內(nèi)部鏈接都返回 404 錯(cuò)誤。這是因?yàn)榉?wù)器在文件系統(tǒng)中找不到與請(qǐng)求 URL 直接對(duì)應(yīng)的物理文件或目錄，而沒有將請(qǐng)求轉(zhuǎn)發(fā)給 index.php 進(jìn)行動(dòng)態(tài)處理。

解決方案：配置 .htAccess 文件

解決此問題的關(guān)鍵在于為 Apache 服務(wù)器配置正確的 URL 重寫規(guī)則。這通常通過在網(wǎng)站的文檔根目錄（在 000webhost 這樣的主機(jī)上通常是 public_html 目錄）中創(chuàng)建一個(gè)或修改現(xiàn)有的 .htaccess 文件來實(shí)現(xiàn)。此文件將指示 Apache 如何處理傳入的請(qǐng)求，確保它們被 Laravel 的 index.php 文件捕獲。

以下是適用于 Laravel 項(xiàng)目的 .htaccess 文件內(nèi)容：

<IfModule mod_rewrite.c> <IfModule mod_negotiation.c>     Options -MultiViews </IfModule>  RewriteEngine On  # 移除尾部斜杠，如果不是目錄的話 RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)/$ /$1 [L,R=301]  # 處理前端控制器：將所有非文件/非目錄請(qǐng)求重寫到 index.php RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L]  # 處理授權(quán)頭部 RewriteCond %{HTTP:Authorization} . RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] </IfModule>

.htaccess 文件內(nèi)容解析：

  1. : 這是一個(gè)條件塊，確保只有在 Apache 服務(wù)器啟用了 mod_rewrite 模塊時(shí)，其中的規(guī)則才會(huì)被應(yīng)用。這是 URL 重寫功能的基礎(chǔ)。
  2. Options -MultiViews : MultiViews 是 Apache 的一個(gè)功能，它允許服務(wù)器嘗試自動(dòng)查找與請(qǐng)求文件名匹配的文件（例如，請(qǐng)求 example 但存在 example.php 或 example.html）。禁用此選項(xiàng)可以防止與 Laravel 的路由系統(tǒng)發(fā)生沖突，確保請(qǐng)求完全由 .htaccess 規(guī)則控制。
  3. RewriteEngine On: 顯式開啟 Apache 的 URL 重寫引擎。
  4. RewriteCond %{REQUEST_FILENAME} !-d 和 *`RewriteRule ^(.)/$ /$1 [L,R=301]`**:
    • RewriteCond %{REQUEST_FILENAME} !-d: 這是一個(gè)條件，表示只有當(dāng)請(qǐng)求的 URI 不是一個(gè)實(shí)際存在的目錄時(shí)，才應(yīng)用后續(xù)的規(guī)則。
    • RewriteRule ^(.*)/$ /$1 [L,R=301]: 這條規(guī)則會(huì)移除 URL 末尾多余的斜杠（例如 example.com/about/ 會(huì)被重定向到 example.com/about）。[L] 表示這是最后一條規(guī)則，[R=301] 表示執(zhí)行一個(gè)永久重定向。
  5. RewriteCond %{REQUEST_FILENAME} !-d 和 RewriteCond %{REQUEST_FILENAME} !-f 和 RewriteRule ^ index.php [L]:
    • RewriteCond %{REQUEST_FILENAME} !-d: 條件，如果請(qǐng)求的 URI 不是一個(gè)實(shí)際存在的目錄。
    • RewriteCond %{REQUEST_FILENAME} !-f: 條件，如果請(qǐng)求的 URI 不是一個(gè)實(shí)際存在的文件。
    • RewriteRule ^ index.php [L]: 這是 Laravel 路由的核心。如果上述兩個(gè)條件都滿足（即請(qǐng)求的 URI 既不是文件也不是目錄），則將所有請(qǐng)求重寫到 index.php。^ 匹配任何請(qǐng)求，[L] 表示這是最后一條重寫規(guī)則。
  6. RewriteCond %{HTTP:Authorization} . 和 *`RewriteRule . – [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]`**:
    • 這兩行規(guī)則確保 HTTP 請(qǐng)求中的 Authorization 頭部信息能夠被正確地傳遞給 PHP 應(yīng)用程序。這對(duì)于處理 API 請(qǐng)求中的認(rèn)證令牌（如 Bearer Token）至關(guān)重要。

實(shí)施步驟

  1. 準(zhǔn)備 Laravel 項(xiàng)目文件： 通常，為了在共享主機(jī)上部署 Laravel，你需要將 Laravel 項(xiàng)目 public 目錄下的所有內(nèi)容（包括 index.php、.htaccess 文件、css/JS/圖片等靜態(tài)資源）直接上傳到主機(jī)的文檔根目錄（例如 public_html）。項(xiàng)目的其余部分（app、bootstrap、vendor 等）應(yīng)該上傳到 public_html 的上一級(jí)目錄或同級(jí)目錄，以保證其安全性和私密性。
  2. 創(chuàng)建或修改 .htaccess 文件：
    • 在你的本地 Laravel 項(xiàng)目的 public 目錄下，通常已經(jīng)有一個(gè) .htaccess 文件。確認(rèn)其內(nèi)容與上述示例一致。
    • 如果你的 public_html 目錄中沒有 .htaccess 文件，或者其內(nèi)容不正確，請(qǐng)創(chuàng)建一個(gè)新文件并粘貼上述代碼。
    • 如果已經(jīng)存在 .htaccess 文件，請(qǐng)備份原有內(nèi)容，然后替換為上述代碼。
  3. 上傳文件： 使用 FTP 客戶端或主機(jī)提供的文件管理器，將修改后的 .htaccess 文件上傳到你的網(wǎng)站根目錄（例如 public_html）。
  4. 清除 Laravel 緩存（可選但推薦）： 部署后，清除 Laravel 應(yīng)用程序的配置、路由和視圖緩存通常是一個(gè)好習(xí)慣，以確保所有更改生效。如果你的主機(jī)支持 ssh 訪問，可以運(yùn)行： 
    php artisan config:clear php artisan route:clear php artisan view:clear

    如果不支持 SSH，可能需要手動(dòng)刪除 bootstrap/cache 目錄下的緩存文件，或者在 public/index.php 中臨時(shí)添加 Artisan::call(‘cache:clear’); 等代碼（完成后務(wù)必刪除）。

注意事項(xiàng)

  • mod_rewrite 模塊： 確保你的共享主機(jī)已啟用 Apache 的 mod_rewrite 模塊。大多數(shù)現(xiàn)代主機(jī)默認(rèn)都會(huì)啟用，但如果問題依然存在，請(qǐng)聯(lián)系你的主機(jī)提供商確認(rèn)。
  • 文件權(quán)限： 確保 .htaccess 文件的權(quán)限設(shè)置正確，通常是 644 或 664，以允許服務(wù)器讀取。
  • 根目錄結(jié)構(gòu)： 上述解決方案假設(shè)你已將 Laravel 項(xiàng)目的 public 目錄內(nèi)容直接放在了網(wǎng)站的文檔根目錄（如 public_html）。如果你的部署結(jié)構(gòu)不同，例如 public_html/laravel/public，那么 .htaccess 文件可能需要放置在 public_html 下，并且可能需要調(diào)整 Laravel 的 index.php 來正確加載框架核心。
  • 其他服務(wù)器類型： 如果你的主機(jī)使用的是 Nginx 而非 Apache，那么 .htaccess 文件將不起作用。Nginx 需要在其配置文件中進(jìn)行類似的 URL 重寫配置。

總結(jié)

通過在共享主機(jī)的文檔根目錄中正確配置 .htaccess 文件，可以有效解決 Laravel 項(xiàng)目部署后內(nèi)部鏈接 404 的問題。這個(gè) .htaccess 文件確保了所有非文件、非目錄的請(qǐng)求都被重定向到 index.php，從而讓 Laravel 的路由系統(tǒng)能夠正常工作。理解其背后的原理和每個(gè)規(guī)則的作用，有助于在遇到類似問題時(shí)進(jìn)行快速排查和解決。

? 版權(quán)聲明
THE END
后端開發(fā)
# php# http# html# nginx# css# JS# laravel# apache# ssh# Access# public# bootstrap# Token# 閉包
喜歡就支持一下吧
點(diǎn)贊11 分享