文件Commerce設定指南

[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

Bootstrap引數

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員

本主題示範如何設定Commerce應用程式啟動程式引數的值。 請參閱應用程式初始化和啟動載入概述。

下表討論您可以設定的啟動程式引數：

Bootstrap引數
說明
MAGE_DIRS
指定自訂目錄和URL路徑
MAGE_PROFILER
啟用相依性圖表和HTML設定檔分析
INFO
  • 並非所有啟動程式引數都記錄下來。
  • 您現在使用magento deploy:mode:set {mode}命令設定應用程式模式（開發人員、預設、生產）。

使用環境變數設定引數

本節將討論如何使用環境變數來設定啟動程式引數的值。

設定應用程式模式

您可以將啟動程式變數指定為系統範圍的環境變數，讓所有程式都能夠使用這些變數。

例如，您可以使用MAGE_PROFILER系統環境變數來指定模式，如下所示：

MAGE_PROFILER={firebug|csv|<custom value>}

使用殼層特定的命令設定變數。 因為殼層有不同的語法，請查閱參考資料，例如unix.stackexchange.com。

CentOS的Bash shell範例：

export MAGE_PROFILER=firebug
INFO
若在您設定效能評測器值後，瀏覽器中顯示PHP Fatal error，請重新啟動網頁伺服器。 原因可能與PHP位元碼快取有關，它會快取位元碼和PHP類別路徑。

設定Apache或Nginx的引數

本節探討如何指定Apache或Nginx的模式。

Nginx設定

檢視[GitHub]上的​ Nginx範例組態。

Apache .htaccess設定

設定應用程式模式的一個方法是編輯.htaccess。 如此一來，您就不必變更Apache設定。

您可以修改下列任一位置的.htaccess，視您進入Commerce應用程式的入口點而定：

  • <magento_root>/.htaccess
  • <magento_root>/pub/.htaccess

設定變數：

  1. 在文字編輯器中開啟任何先前的檔案，並新增或取消註解所要的設定。

    例如，若要指定模式，請取消註解下列專案：

    code language-conf 
    #   SetEnv MAGE_PROFILER firebug

  2. 將MAGE_PROFILER的值設定為下列任一值：

    code language-none 
    firebug
csvfile
<custom value>

  3. 將變更儲存至.htaccess；您不需要重新啟動Apache即可讓變更生效。

Apache設定

Apache Web Server支援使用mod_env指令設定應用程式模式。

在mod_envApache版本2.2[和]Apache版本2.4[中，Apache ]指示詞稍有不同。

下列程式說明如何在Apache虛擬主機中設定應用程式模式。 這不是使用mod_env指示詞的唯一方法；如需詳細資訊，請參閱Apache檔案。

TIP
下節假設您已設定虛擬主機。 如果沒有，請查閱資源，例如此DigitalOcean教學課程。

若要為Ubuntu上的Apache指定啟動程式變數：

  1. 以具有root許可權的使用者身分，在文字編輯器中開啟您的虛擬主機設定檔。

    例如，如果您的虛擬主機名為my.magento，

    • Apache 2.4： vim /etc/apache2/sites-available/my.magento.conf
    • Apache 2.2： vim /etc/apache2/sites-available/my.magento

  2. 在虛擬主機組態中的任何位置，新增下列行：

    code language-conf 
    SetEnv "<variable name>" "<variable value>"

    例如，

    code language-conf 
    SetEnv "MAGE_PROFILER" "firebug"

  3. 儲存變更並退出文字編輯器。

  4. 啟用虛擬主機（如果尚未啟用）：

    code language-bash 
    a2ensite <virtual host config file name>

    例如，

    code language-bash 
    a2ensite my.magento.conf

  5. 設定模式後，請重新啟動網頁伺服器：

    • Ubuntu： service apache2 restart
    • CentOS： service httpd restart
TIP
本節假設您已設定虛擬主機。 如果沒有，請查閱資源，例如此DigitalOcean教學課程。

若要為CentOS上的Apache指定啟動程式變數：

  1. 以具有root許可權的使用者身分，在文字編輯器中開啟/etc/httpd/conf/httpd.conf。

  2. 在虛擬主機組態中的任何位置，新增下列行：

    code language-conf 
    SetEnv "<variable name>" "<variable value>"

    例如，

    code language-conf 
    SetEnv "MAGE_PROFILER" "firebug"

  3. 儲存變更並退出文字編輯器。

  4. 設定模式後，請重新啟動網頁伺服器：

    • Ubuntu： service apache2 restart
    • CentOS： service httpd restart
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c