.jpg)
本教程詳細(xì)闡述了在將laravel應(yīng)用部署到共享主機(jī)（如000webhost）時，鏈接失效并出現(xiàn)404錯誤的原因及解決方案。核心在于通過配置.htaccess文件，確保服務(wù)器正確處理URL重寫，將所有請求路由至Laravel的入口文件index.php，從而恢復(fù)應(yīng)用的正常路由功能。
問題背景：Laravel應(yīng)用在共享主機(jī)上的路由挑戰(zhàn)
當(dāng)您在本地開發(fā)環(huán)境中運(yùn)行Laravel應(yīng)用時，所有路由通常都能正常工作。然而，一旦將項目部署到共享主機(jī)（例如000webhost）上，您可能會遇到所有鏈接都返回“Page Not Found – Error 404”的問題，盡管首頁可能可以正常訪問。這通常不是代碼邏輯錯誤，而是服務(wù)器環(huán)境配置不當(dāng)，未能正確處理Laravel的URL重寫機(jī)制所致。
Laravel框架采用“單一入口”模式，所有請求都應(yīng)通過public/index.php文件進(jìn)行處理。這意味著，無論用戶訪問哪個URL路徑，Web服務(wù)器（如apache）都需要將這些請求內(nèi)部重寫到index.php，然后由Laravel的路由系統(tǒng)來解析并分發(fā)請求。在Apache服務(wù)器上，這一重寫功能主要依賴于mod_rewrite模塊和.htAccess文件。如果服務(wù)器沒有啟用mod_rewrite模塊，或者.htaccess文件配置不正確或缺失，服務(wù)器就無法將請求正確導(dǎo)向index.php，從而導(dǎo)致404錯誤。
核心解決方案：配置.htaccess文件
解決Laravel在共享主機(jī)上鏈接失效問題的關(guān)鍵在于在網(wǎng)站的根目錄（通常是public_html）中創(chuàng)建一個正確的.htaccess文件。這個文件會告訴Apache服務(wù)器如何處理傳入的URL請求，確保它們被Laravel的index.php入口文件捕獲。
以下是用于解決此問題的標(biāo)準(zhǔn).htaccess文件內(nèi)容：
<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項目部署到的網(wǎng)站根目錄（例如，000webhost上的public_html文件夾）中，創(chuàng)建一個名為.htaccess的新文件。
- 將上述代碼復(fù)制并粘貼到新創(chuàng)建的.htaccess文件中。
- 保存文件。
.htaccess文件內(nèi)容解析
讓我們逐行解析這個.htaccess文件的作用：
-
和 : 這對標(biāo)簽確保了只有當(dāng)Apache的mod_rewrite模塊被加載時，內(nèi)部的規(guī)則才會生效。這是一個良好的實踐，可以避免在不支持mod_rewrite的環(huán)境中引發(fā)服務(wù)器錯誤。 -
和 Options -MultiViews: MultiViews是一個Apache選項，它允許服務(wù)器在找不到精確匹配的文件時，嘗試通過內(nèi)容協(xié)商來查找文件。對于Laravel這樣的框架，它可能會干擾URL重寫，導(dǎo)致意外的行為。Options -MultiViews禁用了此功能，確保URL重寫規(guī)則能夠按預(yù)期工作。 - RewriteEngine On: 這是啟用Apache重寫引擎的指令。沒有它，下面的所有重寫規(guī)則都不會生效。
- # Redirect Trailing Slashes If Not A Folder…:
- RewriteCond %{REQUEST_FILENAME} !-d: 這是一個條件，表示如果請求的URI不是一個存在的目錄。
- RewriteRule ^(.*)/$ /$1 [L,R=301]: 如果URI以斜杠結(jié)尾且不是一個目錄，則移除末尾的斜杠并進(jìn)行301永久重定向。這有助于規(guī)范URL格式，避免重復(fù)內(nèi)容。
- # Handle Front Controller…: 這是將所有請求導(dǎo)向Laravel index.php的核心規(guī)則。
- RewriteCond %{REQUEST_FILENAME} !-d: 條件一，如果請求的URI不是一個存在的目錄。
- RewriteCond %{REQUEST_FILENAME} !-f: 條件二，如果請求的URI不是一個存在的文件。
- RewriteRule ^ index.php [L]: 如果以上兩個條件都滿足（即請求的URI既不是一個文件也不是一個目錄），那么將請求內(nèi)部重寫到index.php。[L]標(biāo)志表示這是最后一條規(guī)則，停止進(jìn)一步的重寫處理。
- # Handle Authorization Header:
- RewriteCond %{HTTP:Authorization} .: 檢查HTTP請求頭中是否存在Authorization字段。
- RewriteRule .* – [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]: 如果存在Authorization頭，將其值設(shè)置到一個名為HTTP_AUTHORIZATION的環(huán)境變量中。這對于處理API請求中的認(rèn)證信息（如Bearer Token）至關(guān)重要，確保Laravel能夠正確接收和解析。
注意事項
- 服務(wù)器環(huán)境要求： 確保您的共享主機(jī)（如000webhost）支持Apache服務(wù)器，并且已啟用mod_rewrite模塊。大多數(shù)現(xiàn)代共享主機(jī)都會默認(rèn)啟用。
- 文件放置準(zhǔn)確性： .htaccess文件必須放置在您網(wǎng)站的根目錄中，通常是public_html。如果您的Laravel項目結(jié)構(gòu)是：public_html/your_laravel_project/public/，那么您可能需要將.htaccess文件放置在public_html/your_laravel_project/public/目錄下，或者將Laravel public目錄下的所有內(nèi)容直接移動到public_html中，并將.htaccess文件放在public_html中。本教程的解決方案假設(shè)您已將Laravel的public目錄內(nèi)容直接部署到了public_html。
- Laravel項目結(jié)構(gòu)： 確保您的Laravel項目中的public文件夾內(nèi)的所有內(nèi)容（包括index.php、.htaccess等）都已正確地復(fù)制到了服務(wù)器的網(wǎng)站根目錄（例如public_html）。
- 緩存問題： 在修改.htaccess文件后，建議清除瀏覽器緩存，有時服務(wù)器端也可能存在緩存，可能需要等待一段時間或聯(lián)系主機(jī)提供商清除。
- 權(quán)限問題： 確保.htaccess文件具有正確的讀取權(quán)限（通常是644），以便Web服務(wù)器能夠訪問和解析它。
總結(jié)
通過在共享主機(jī)環(huán)境的網(wǎng)站根目錄中正確配置.htaccess文件，可以有效地解決Laravel應(yīng)用部署后鏈接失效的404問題。這個文件是Apache服務(wù)器上Laravel應(yīng)用正常運(yùn)行的關(guān)鍵，它確保了所有非文件、非目錄的請求都能被正確地重定向到Laravel的index.php入口文件，從而激活框架的路由系統(tǒng)。理解并正確應(yīng)用這些配置，是成功部署Laravel應(yīng)用到共享主機(jī)的重要一步。
.png)
