管理擴充功能
您可以從Commerce Marketplace新增擴充功能,以擴充您的Adobe Commerce應用程式功能。 例如,您可以新增佈景主題來變更店面的外觀和風格,或新增語言套件來本地化您的店面和管理員。
副檔名的撰寫器名稱
雖然本節討論如何從Commerce Marketplace取得副檔名的Composer名稱和版本,但您可以在模組的Composer檔案中找到 any 模組的名稱和版本。 在文字編輯器中開啟composer.json
檔案,並記下"name"
和"version"
值。
若要從Commerce Marketplace 取得模組的撰寫器名稱:
-
以您購買元件的使用者名稱和密碼登入Commerce Marketplace。
-
在右上角,按一下您的使用者名稱並選取 我的設定檔。
-
在 我的帳戶 頁面上,按一下 我的購買。
-
在 我的購買 頁面上,選取您購買的模組,然後按一下 技術詳細資料。
-
按一下「複製」將Component name複製到剪貼簿。
-
開啟文字編輯器並貼上元件名稱,然後附加冒號字元(
:
)。 -
在 技術詳細資料 中,按一下 複製 將Component version複製到剪貼簿。
-
在文字編輯器中,將版本編號附加至冒號後的元件名稱。 例如:
code language-text extension-name/magento2:1.0.1
安裝擴充功能
當您將擴充功能新增至實作時,Adobe建議在開發分支中工作。 安裝擴充功能時,擴充功能名稱(<VendorName>_<ComponentName>
)會自動插入app/etc/config.php
檔案中。 不需要直接編輯檔案。
若要安裝擴充功能:
-
在本機工作站上,變更至專案目錄。
-
建立或簽出開發分支。 請參閱分支。
-
使用撰寫器名稱和版本,將副檔名新增至
composer.json
檔案的require
區段。code language-bash composer require <extension-name>:<version> --no-update
-
更新專案相依性。
code language-bash composer update
-
新增、提交和推送程式碼變更。
code language-bash git add -A
code language-bash git commit -m "Install <extension-name>"
code language-bash git push origin <branch-name>
note warning WARNING 安裝擴充功能時,您必須將程式碼變更推播至遠端環境時包含 composer.lock
檔案。composer install
命令會讀取composer.lock
檔案,以啟用遠端環境中定義的相依性。 -
建置和部署完成後,請使用SSH登入遠端環境並確認已安裝擴充功能。
code language-bash bin/magento module:status <extension-name>
副檔名使用格式:
<VendorName>_<ComponentName>
。範例回應:
code language-none Module is enabled
如果您遇到部署錯誤,請參閱擴充功能部署失敗。
管理擴充功能
當您使用Composer新增擴充功能時,部署程式會自動啟用擴充功能。 如果您已安裝擴充功能,可以使用CLI啟用或停用擴充功能。 管理擴充功能時,請使用格式: <VendorName>_<ComponentName>
登入遠端環境時,切勿啟用或停用擴充功能。
若要啟用或停用擴充功能:
-
在本機工作站上,變更至專案目錄。
-
啟用或停用模組。
module
命令以模組要求的狀態更新config.php
檔案。啟用模組。
code language-bash bin/magento module:enable <module-name>
停用模組。
code language-bash bin/magento module:disable <module-name>
-
如果您已啟用模組,請使用
ece-tools
重新整理組態。code language-bash ./vendor/bin/ece-tools module:refresh
-
驗證模組的狀態。
code language-bash bin/magento module:status <module-name>
-
新增、提交和推送程式碼變更。
code language-bash git add -A
code language-bash git commit -m "Disable <extension-name>"
code language-bash git push origin <branch-names>
升級擴充功能
繼續進行之前,您需要該擴充功能的撰寫器名稱和版本。 此外,請確認擴充功能與您的專案和Adobe Commerce版本相容。 特別是,在您開始之前檢查所需的PHP版本。
若要更新擴充功能:
-
在本機工作站上,變更至專案目錄。
-
建立或簽出開發分支。 請參閱分支。
-
在文字編輯器中開啟
composer.json
檔案。 -
找到您的擴充功能並更新版本。
-
儲存變更並退出文字編輯器。
-
更新專案相依性。
code language-bash composer update
-
新增、提交和推送您的程式碼變更。
code language-bash git add -A
code language-bash git commit -m "Update <extension-name>"
code language-bash git push origin <branch-names>
如果發生錯誤,請參閱從元件失敗復原。 若要進一步瞭解如何將擴充功能與Adobe Commerce搭配使用,請參閱 管理指南 中的擴充功能。