本文旨在指導(dǎo)開(kāi)發(fā)者如何在 Nginx 環(huán)境下，通過(guò) PHP-FPM 正確配置 Laravel 應(yīng)用，使其能夠解析 PHP 文件。文章將詳細(xì)介紹配置 Nginx 的關(guān)鍵步驟，并提供示例代碼，幫助開(kāi)發(fā)者解決在 Nginx 中部署 Laravel 應(yīng)用時(shí)遇到的 PHP 文件解析問(wèn)題，確保應(yīng)用能夠正常運(yùn)行。

在使用 Nginx 部署 Laravel 應(yīng)用時(shí)，一個(gè)常見(jiàn)的需求是將特定路徑（例如 /api）指向 Laravel 應(yīng)用，而保持其他路徑指向其他服務(wù)（例如 React 應(yīng)用）。 當(dāng)配置不正確時(shí)，可能會(huì)出現(xiàn) Nginx 無(wú)法正確解析 PHP 文件，導(dǎo)致在瀏覽器中直接顯示 PHP 代碼而不是執(zhí)行結(jié)果。以下是如何解決此問(wèn)題的詳細(xì)步驟。

確保已安裝 PHP-FPM

PHP-FPM（FastCGI Process Manager）是用于處理 PHP 請(qǐng)求的進(jìn)程管理器。 確保你的服務(wù)器上已經(jīng)安裝了 PHP-FPM，并且版本與你的 Laravel 應(yīng)用兼容。你可以使用以下命令安裝 PHP-FPM，具體版本號(hào)根據(jù)你的 PHP 版本進(jìn)行調(diào)整：

sudo apt-get update
sudo apt-get install php8.1-fpm  # 示例：安裝 PHP 8.1 的 PHP-FPM

安裝完成后，啟動(dòng) PHP-FPM 服務(wù)：

sudo systemctl start php8.1-fpm  # 示例：?jiǎn)?dòng) PHP 8.1 的 PHP-FPM
sudo systemctl enable php8.1-fpm # 設(shè)置開(kāi)機(jī)自啟

配置 Nginx

接下來(lái)，需要配置 Nginx 以將特定路徑的請(qǐng)求轉(zhuǎn)發(fā)到 PHP-FPM。編輯 Nginx 的配置文件（通常位于 /etc/nginx/sites-available/ 目錄下），找到與你的 Laravel 應(yīng)用相關(guān)的 server 塊。

假設(shè)你希望將 /api 路徑指向 Laravel 應(yīng)用，以下是一個(gè)示例配置：

server {
    listen 80;
    server_name domain.com;
    root /var/www/app; # React 應(yīng)用的根目錄

    index index.html;

    location /api {
        alias /var/www/api/public/; # Laravel 應(yīng)用的 public 目錄
        try_files $uri $uri/ /api/index.php?$query_string;

        location ~ \.php$ {
            #root /var/www/api/public; # 注釋掉，因?yàn)橐呀?jīng)在 location /api 中定義了 alias

            include snippets/fastcgi-php.conf; # 包含 PHP-FPM 的通用配置
            fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 指定 PHP-FPM 的 socket 文件路徑
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }

    location / {
        # React 應(yīng)用的配置
        try_files $uri $uri/ =404;
    }
}

配置詳解：

• location /api: 定義了處理 /api 路徑的規(guī)則。
  • alias /var/www/api/public/：指定 Laravel 應(yīng)用的 public 目錄為 /api 的根目錄。
  • try_files $uri $uri/ /api/index.php?$query_string;：嘗試查找請(qǐng)求的 URI 作為文件或目錄。如果找不到，則將請(qǐng)求重定向到 Laravel 的入口文件 index.php，并傳遞查詢字符串。
• location ~ \.php$: 定義了處理 PHP 文件的規(guī)則。
  • include snippets/fastcgi-php.conf;：包含 Nginx 提供的 PHP-FPM 通用配置，其中包含一些常用的 fastcgi_param 設(shè)置。
  • fastcgi_pass unix:/run/php/php8.1-fpm.sock;：指定 PHP-FPM 的 socket 文件路徑。請(qǐng)根據(jù)你的 PHP-FPM 版本和配置進(jìn)行調(diào)整。可以使用 ps aux | grep php-fpm 查找 socket 文件路徑。
  • fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;：設(shè)置 SCRIPT_FILENAME 參數(shù)，告訴 PHP-FPM 要執(zhí)行的 PHP 文件路徑。 $document_root 是 Nginx 的根目錄，$fastcgi_script_name 是請(qǐng)求的 PHP 文件名。
• location /: 定義了處理根目錄的規(guī)則，此處配置為React應(yīng)用。

注意事項(xiàng)：

• 確保 fastcgi_pass 指向正確的 PHP-FPM socket 文件路徑。
• 根據(jù)你的 PHP 版本調(diào)整 PHP-FPM 的配置和 socket 文件路徑。
• 檢查文件和目錄權(quán)限，確保 Nginx 和 PHP-FPM 進(jìn)程有權(quán)訪問(wèn) Laravel 應(yīng)用的文件。

重啟 Nginx 和 PHP-FPM

完成配置后，保存文件并重啟 Nginx 和 PHP-FPM 服務(wù)：

sudo nginx -t # 測(cè)試配置是否正確
sudo systemctl restart nginx
sudo systemctl restart php8.1-fpm # 示例：重啟 PHP 8.1 的 PHP-FPM

測(cè)試配置

現(xiàn)在，你可以通過(guò)訪問(wèn) domain.com/api 來(lái)測(cè)試 Laravel 應(yīng)用是否能夠正確解析 PHP 文件。 如果一切配置正確，你應(yīng)該能夠看到 Laravel 應(yīng)用的頁(yè)面。

總結(jié)

通過(guò)以上步驟，你應(yīng)該能夠成功配置 Nginx 和 PHP-FPM，使 Laravel 應(yīng)用能夠正確解析 PHP 文件，并與其他服務(wù)（例如 React 應(yīng)用）共存。 請(qǐng)務(wù)必根據(jù)你的實(shí)際環(huán)境和 PHP 版本調(diào)整配置，并確保文件和目錄權(quán)限正確。

以上是使用 Nginx 和 PHP-FPM 配置 Laravel 應(yīng)用的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！