技術細節

本主題說明Commerce 2.2和更新版本中管道部署的技術實作詳細資訊。 改良功能可劃分為下列領域：

此主題也會討論用於管道部署的建議工作流程，並提供一些範例來協助您瞭解其運作方式。

開始之前，請先檢閱開發、組建和生產系統的必要條件。

設定管理

若要讓您同步化及維護開發及生產系統的組態，請使用下列覆寫配置。

如圖所示，組態值使用順序如下：

管理共用設定

共用組態儲存在app/etc/config.php中，應該是在原始檔控制中。

在開發中的管理員(或雲端基礎結構​ 整合 ​上的Adobe Commerce)系統中設定共用設定，並使用magento app:config:dump命令將設定寫入config.php。

管理系統特定設定

系統特定組態儲存在app/etc/env.php中，它應該​ 不 ​在原始檔控制中。

在您的開發(或雲端基礎結構整合上的Adobe Commerce)系統中，於Admin中設定系統專屬設定，並使用magento app:config:dump命令將設定寫入env.php。

這個命令也會將敏感設定寫入env.php。

管理敏感設定

敏感設定也儲存在app/etc/env.php中。

您可以透過下列任何方式管理敏感設定：

在Admin中鎖定的組態設定

config.php或env.php中的任何組態設定已在Admin中鎖定；也就是說，這些設定無法在Admin中變更。
使用magento config:set或magento config:set --lock命令變更config.php或env.php檔案中的設定。

Commerce管理員

在生產模式中，管理員會顯示下列行為：

安裝和移除cron

在2.2版中，我們首次提供magento cron:install命令來協助您設定cron工作。 這個命令會將crontab設定為執行命令的使用者。

您也可以使用magento cron:remove命令移除crontab。

建議的管道部署工作流程

下圖顯示我們建議您使用管道部署來管理設定的方式。

開發系統

在您的開發系統上，您在[管理員]中進行組態變更，並產生共用組態app/etc/config.php和系統特定組態app/etc/env.php。 檢查Commerce程式碼和共用設定至原始檔控制，並將其推送至組建伺服器。

您也應在開發系統上安裝擴充功能並自訂Commerce程式碼。

在您的開發系統上：

執行清除資產的命令後，Commerce會產生工作檔案。

建置系統

組建系統會編譯程式碼，並針對在Commerce中註冊的主題產生靜態檢視檔案。 不需要連線至Commerce資料庫，只需要使用Commerce程式碼基底。

在您的建置系統上：

生產系統

在您的生產系統（即您的即時商店）上，您會從原始檔控制提取產生的資產和程式碼更新，並使用命令列或環境變數設定系統專屬和敏感的組態設定。

在您的生產系統上：

組態管理命令

我們提供下列指令來協助您管理組態：

設定管理範例

本節顯示管理組態的範例，讓您瞭解如何變更config.php和env.php。

變更預設地區設定

此區段顯示當您使用管理員（商店 >設定> 組態 >一般> 一般 > 地區設定選項）變更預設權重單位時對config.php所做的變更。

在管理員中進行變更後，請執行bin/magento app:config:dump將值寫入config.php。 值會寫入locale下的general陣列，因為config.php中的下列程式碼片段顯示：

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

變更數個組態設定

本節將討論進行下列組態變更：

在管理員中進行變更後，請在開發系統上執行bin/magento app:config:dump。 這次，並非所有變更都會寫入config.php；事實上，只有網站、商店和商店檢視會寫入該檔案，如下列程式碼片段所示。

config.php

config.php包含：

websites陣列：

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups陣列：

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores陣列：

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment陣列：

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

預設的電子郵件網域系統特定組態設定已寫入app/etc/env.php。

PayPal設定不會寫入這兩個檔案，因為bin/magento app:config:dump命令不會寫入敏感性設定。 您必須使用下列命令在生產系統上設定PayPal設定：

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>