解決Laravel項(xiàng)目在共享主機(jī)上鏈接失效的404問(wèn)題

418

解決Laravel項(xiàng)目在共享主機(jī)上鏈接失效的404問(wèn)題

本文旨在解決laravel應(yīng)用部署到共享主機(jī)（如000webhost）后，內(nèi)部鏈接出現(xiàn)404錯(cuò)誤的問(wèn)題。核心解決方案是配置一個(gè)正確的.htaccess文件，以確保服務(wù)器能夠正確處理Laravel的URL重寫(xiě)規(guī)則，將所有請(qǐng)求路由到index.php前端控制器，從而使路由和鏈接功能正常運(yùn)作。

問(wèn)題背景與根源分析

當(dāng)Laravel項(xiàng)目在本地開(kāi)發(fā)環(huán)境（如Laravel Valet、Laragon、XAMPP等）中運(yùn)行時(shí)，其內(nèi)部鏈接通常工作正常。然而，一旦將項(xiàng)目部署到共享主機(jī)（例如000webhost），用戶(hù)可能會(huì)遇到所有非根路徑的鏈接都返回“Page Not Found – Error 404”的錯(cuò)誤。這通常是由于服務(wù)器未能正確處理Laravel框架的URL重寫(xiě)機(jī)制導(dǎo)致的。

Laravel框架采用“單一入口”模式，所有請(qǐng)求都應(yīng)通過(guò)public/index.php文件進(jìn)行處理。為了實(shí)現(xiàn)這一目標(biāo)，Laravel依賴(lài)于apache服務(wù)器的mod_rewrite模塊來(lái)將友好的URL（例如/posts/1）重寫(xiě)為內(nèi)部路徑，并最終指向index.php。在共享主機(jī)環(huán)境中，如果.htAccess文件配置不當(dāng)，或者mod_rewrite模塊未啟用或配置有誤，服務(wù)器就無(wú)法識(shí)別這些友好的URL，從而導(dǎo)致404錯(cuò)誤。

解決方案：配置.htaccess文件

解決此問(wèn)題的關(guān)鍵是在Web服務(wù)器的根目錄（通常是public_html或與你的Laravel public目錄對(duì)應(yīng)的路徑）放置一個(gè)正確的.htaccess文件。這個(gè)文件將指示Apache服務(wù)器如何處理傳入的請(qǐng)求，確保它們被Laravel的index.php文件正確處理。

以下是適用于大多數(shù)Laravel項(xiàng)目在共享主機(jī)上運(yùn)行的.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>

.htaccess配置詳解

讓我們逐行分析上述.htaccess文件的作用：

  • : 這是一個(gè)條件塊，確保只有在A(yíng)pache的mod_rewrite模塊啟用時(shí)，內(nèi)部的規(guī)則才會(huì)被應(yīng)用。這是非常重要的，因?yàn)槿绻K未啟用，這些規(guī)則會(huì)導(dǎo)致服務(wù)器錯(cuò)誤。
  • 和 Options -MultiViews: MultiViews選項(xiàng)是Apache mod_negotiation模塊的一部分，它允許服務(wù)器在請(qǐng)求一個(gè)文件時(shí)，自動(dòng)查找具有不同擴(kuò)展名的文件（例如，請(qǐng)求example可能會(huì)找到example.php）。對(duì)于Laravel這種依賴(lài)精確URL路由的框架，MultiViews可能會(huì)干擾其路由機(jī)制，因此通常需要禁用它。
  • RewriteEngine On: 開(kāi)啟URL重寫(xiě)引擎，這是所有重寫(xiě)規(guī)則生效的前提。
  • RewriteCond %{REQUEST_FILENAME} !-d: 這是一個(gè)重寫(xiě)條件。它檢查當(dāng)前請(qǐng)求的文件名是否不是一個(gè)目錄。
  • *`RewriteRule ^(.)/$ /$1 [L,R=301]`**: 如果請(qǐng)求的URL以斜杠結(jié)尾且不是一個(gè)實(shí)際的目錄，這條規(guī)則會(huì)移除末尾的斜杠并進(jìn)行301永久重定向。這有助于保持URL的規(guī)范化，避免重復(fù)內(nèi)容。
  • RewriteCond %{REQUEST_FILENAME} !-d 和 RewriteCond %{REQUEST_FILENAME} !-f: 這兩個(gè)條件是核心。它們檢查當(dāng)前請(qǐng)求的文件名是否不是一個(gè)實(shí)際的目錄（-d）且不是一個(gè)實(shí)際的文件（-f）。這意味著如果請(qǐng)求的URL不對(duì)應(yīng)服務(wù)器上的任何現(xiàn)有文件或目錄，那么它就應(yīng)該被Laravel處理。
  • RewriteRule ^ index.php [L]: 這是主要的重寫(xiě)規(guī)則。如果前面的條件都滿(mǎn)足，它會(huì)將所有請(qǐng)求重寫(xiě)到index.php文件。[L]標(biāo)志表示這是最后一條規(guī)則，停止進(jìn)一步的重寫(xiě)處理。
  • *RewriteCond %{HTTP:Authorization} . 和 `RewriteRule . – [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]**: 這兩行處理HTTP授權(quán)頭。某些情況下，Apache可能會(huì)在內(nèi)部清除Authorization頭，導(dǎo)致API認(rèn)證失敗。這些規(guī)則確保Authorization`頭被正確傳遞給PHP應(yīng)用程序。

部署步驟與注意事項(xiàng)

  1. 創(chuàng)建或編輯.htaccess文件:

    • 在你的本地Laravel項(xiàng)目的public目錄下，確保存在一個(gè)名為.htaccess的文件。如果不存在，請(qǐng)創(chuàng)建一個(gè)。
    • 將上述代碼復(fù)制并粘貼到這個(gè).htaccess文件中。

  2. 上傳到共享主機(jī):

    • 使用FTP客戶(hù)端（如FileZilla）或主機(jī)提供的文件管理器，連接到你的共享主機(jī)。

    • 導(dǎo)航到你的網(wǎng)站根目錄。對(duì)于000webhost，通常是public_html。

    • 將你的Laravel項(xiàng)目的內(nèi)容（而不是整個(gè)項(xiàng)目文件夾）上傳到public_html。特別地，Laravel的public文件夾內(nèi)的所有內(nèi)容（包括index.php和剛剛配置的.htaccess）應(yīng)該直接位于public_html下。其他Laravel項(xiàng)目文件夾（如app, bootstrap, vendor等）應(yīng)該放在public_html的上一級(jí)目錄或一個(gè)非公開(kāi)可訪(fǎng)問(wèn)的目錄中。

    • 重要提示: 如果你的主機(jī)要求所有文件都在public_html下，那么你需要調(diào)整Laravel的index.php文件，使其能夠正確加載位于public_html內(nèi)的其他Laravel核心文件。這通常涉及修改index.php中對(duì)../vendor/autoload.php和../bootstrap/app.php的路徑引用。例如，如果所有內(nèi)容都在public_html下，則可能需要將../移除或替換為正確的相對(duì)路徑。

    • 標(biāo)準(zhǔn)部署結(jié)構(gòu)示例 (推薦):

      / ├── my_laravel_app_root/  <-- 這是你Laravel項(xiàng)目的所有文件（除了public內(nèi)容） │   ├── app/ │   ├── bootstrap/ │   ├── config/ │   ├── ... │   └── vendor/ ├── public_html/          <-- 這是Web服務(wù)器的公開(kāi)根目錄 │   ├── .htaccess         <-- 放置上述代碼 │   ├── index.php         <-- Laravel的入口文件 │   ├── css/ │   ├── js/ │   └── ... (public資產(chǎn))

      在這種結(jié)構(gòu)下，你需要編輯public_html/index.php來(lái)指向my_laravel_app_root中的vendor/autoload.php和bootstrap/app.php。

      • 修改public_html/index.php中的路徑：

        // Original: // require __DIR__.'/../vendor/autoload.php'; // $app = require_once __DIR__.'/../bootstrap/app.php';  // Modified (assuming my_laravel_app_root is sibling to public_html): require __DIR__.'/../my_laravel_app_root/vendor/autoload.php'; $app = require_once __DIR__.'/../my_laravel_app_root/bootstrap/app.php';

  3. 清除Laravel緩存:

    • 部署后，通過(guò)ssh或主機(jī)提供的終端運(yùn)行以下命令（如果主機(jī)支持）： 
      php artisan cache:clear php artisan config:clear php artisan route:clear php artisan view:clear
    • 如果無(wú)法SSH訪(fǎng)問(wèn)，可以臨時(shí)在public/index.php（或public_html/index.php）中添加一行代碼來(lái)執(zhí)行這些命令，訪(fǎng)問(wèn)一次后立即刪除。 
      // 在 index.php 文件的頂部添加（臨時(shí)用，用完刪除） // Artisan::call('cache:clear'); // Artisan::call('config:clear'); // Artisan::call('route:clear'); // Artisan::call('view:clear');

  4. 檢查文件權(quán)限:

    • 確保storage和bootstrap/cache目錄及其子目錄具有Web服務(wù)器用戶(hù)（通常是www-data或nobody）的寫(xiě)入權(quán)限（通常是775或777）。

總結(jié)

解決Laravel項(xiàng)目在共享主機(jī)上鏈接失效的404問(wèn)題，核心在于正確配置.htaccess文件，以確保Apache服務(wù)器能夠?qū)⑺蟹俏募?目錄的請(qǐng)求重寫(xiě)到Laravel的index.php前端控制器。同時(shí)，合理的項(xiàng)目文件結(jié)構(gòu)和正確的Laravel緩存清理也是確保應(yīng)用正常運(yùn)行的關(guān)鍵。通過(guò)遵循上述步驟，可以有效解決大多數(shù)此類(lèi)部署問(wèn)題，使Laravel應(yīng)用在共享主機(jī)環(huán)境中穩(wěn)定運(yùn)行。

? 版權(quán)聲明
THE END
后端開(kāi)發(fā)
# php# ai# http# red# css# laravel# apache# ssh# Access# Error# public# bootstrap
喜歡就支持一下吧
點(diǎn)贊8 分享