拡張機能の管理
から拡張機能を追加することで、Adobe Commerce アプリケーションの機能を拡張できます。 Commerce Marketplace. 例えば、テーマを追加してストアフロントのルックアンドフィールを変更したり、言語パッケージを追加してストアフロントと管理者をローカライズしたりできます。
拡張機能のコンポーザー名
このセクションでは、Commerce Marketplaceから Composer 名と拡張機能のバージョンを取得する方法について説明しますが、 いずれか モジュールの Composer ファイル内のモジュール。 を開きます composer.json
ファイルをテキストエディターで開き、 "name"
および "version"
値。
Commerce Marketplaceからモジュールの Composer 名を取得するには:
-
へのログイン Commerce Marketplace と、コンポーネントの購入に使用したユーザー名およびパスワード。
-
右上隅のユーザー名をクリックし、を選択します。 マイプロファイル.
-
日 マイアカウント ページ、クリック 購入状況.
-
日 購入状況 ページで購入したモジュールを選択し、クリックします 技術的詳細.
-
クリック コピー をコピーします Component name をクリップボードに追加します。
-
テキストエディターを開き、コンポーネント名を貼り付けて、コロン文字(
:
)に設定します。 -
対象: 技術的詳細 を選択し、 コピー をコピーします Component version をクリップボードに追加します。
-
テキストエディターで、コンポーネント名のコロンの後にバージョン番号を追加します。 例:
code language-text extension-name/magento2:1.0.1
拡張機能のインストール
Adobeでは、実装に拡張機能を追加する際に、開発ブランチで作業することをお勧めします。 拡張機能をインストールする場合、拡張機能名(<VendorName>_<ComponentName>
)が app/etc/config.php
ファイル。 ファイルを直接編集する必要はありません。
拡張機能をインストールするには:
-
ローカルワークステーションで、をプロジェクトディレクトリに変更します。
-
開発ブランチを作成またはチェックアウトします。 参照: 分岐.
-
Composer の名前とバージョンを使用して、拡張機能をに追加します
require
の節composer.json
ファイル。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-terminal 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>
拡張機能のアップグレード
続行する前に、拡張機能の Composer 名とバージョンが必要です。 また、拡張機能がプロジェクトおよび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での拡張機能の使用について詳しくは、 拡張機能 が含まれる 管理ガイド.