ドキュメントCommerceクラウドインフラストラクチャー上の Commerce に関するガイド

拡張機能の管理

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • 開発者

Commerce Marketplace から拡張機能を追加して、Adobe Commerce アプリケーションの機能を拡張できます。 例えば、テーマを追加してストアフロントのルックアンドフィールを変更したり、言語パッケージを追加してストアフロントと管理者をローカライズしたりできます。

NOTE
インストールの問題を回避するには、すべての Marketplace での購入を、クラウドプロジェクトを所有するのと同じアカウント（MAGEID）を使用して完了する必要があります。

拡張機能のコンポーザー名

このセクションでは、Commerce Marketplaceから Composer 名と拡張機能のバージョンを取得する方法について説明していますが、モジュールの Composer ファイル内で any モジュールの名前とバージョンを見つけることができます。 composer.json ファイルをテキストエディターで開き、"name" と "version" の値をメモします。

Commerce Marketplaceからモジュールの Composer 名を取得するには:

  1. コンポーネントの購入に使用したユーザー名とパスワードを使用して 🔗Commerce Marketplaceにログインします。

  2. 右上隅でユーザー名をクリックし、「マイプロファイル」を選択します。

    Marketplace アカウントにアクセス

  3. マイアカウント ページで 購入履歴 をクリックします。

    Marketplace の購入履歴

  4. 購入 ページで、購入したモジュールを選択し、「技術的な詳細 をクリック ます。

  5. コピー をクリックして、Component name をクリップボードにコピーします。

  6. テキストエディターを開き、コンポーネント名を貼り付け、コロン文字（:）を追加します。

  7. 技術的な詳細 で コピー をクリックして、Component version をクリップボードにコピーします。

  8. テキストエディターで、コンポーネント名のコロンの後にバージョン番号を追加します。 例：

    code language-text 
    extension-name/magento2:1.0.1

拡張機能のインストール

Adobeでは、実装に拡張機能を追加する際に、開発ブランチで作業することをお勧めします。 拡張機能をインストールすると、拡張機能名（<VendorName>_<ComponentName>）が app/etc/config.php ファイルに自動的に挿入されます。 ファイルを直接編集する必要はありません。

拡張機能をインストールするには:

  1. ローカルワークステーションで、をプロジェクトディレクトリに変更します。

  2. 開発ブランチを作成またはチェックアウトします。 ブランチを参照してください。

  3. Composer の名前とバージョンを使用して、composer.json ファイルの require セクションに拡張子を追加します。

    code language-bash 
    composer require <extension-name>:<version> --no-update

  4. プロジェクトの依存関係を更新します。

    code language-bash 
    composer update

  5. コードの変更を追加、コミットおよびプッシュします。

    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 ファイルを読み取って、リモート環境で定義された依存関係を有効にします。

  6. ビルドおよびデプロイが完了したら、SSH を使用してリモート環境にログインし、インストールされている拡張機能を確認します。

    code language-bash 
    bin/magento module:status <extension-name>

    拡張機能名には、<VendorName>_<ComponentName> の形式を使用します。

    応答の例：

    code language-none 
    Module is enabled

    デプロイメントエラーが発生した場合は、 拡張機能のデプロイメントの失敗を参照してください。

拡張機能の管理

Composer を使用して拡張機能を追加すると、デプロイメント プロセスによって拡張機能が自動的に有効になります。 拡張機能が既にインストールされている場合は、CLI を使用して拡張機能を有効または無効にできます。 拡張機能を管理する場合、<VendorName>_<ComponentName> の形式を使用します。

リモート環境にログインしている間は、拡張機能を有効または無効にしないでください。

拡張機能を有効または無効にするには:

  1. ローカルワークステーションで、をプロジェクトディレクトリに変更します。

  2. モジュールを有効または無効にします。 module コマンドは、要求されたモジュールのステータスで config.php ファイルを更新します。

    モジュールを有効にします。

    code language-bash 
    bin/magento module:enable <module-name>

    モジュールを無効にします。

    code language-bash 
    bin/magento module:disable <module-name>

  3. モジュールを有効にした場合は、ece-tools を使用して設定を更新します。

    code language-bash 
    ./vendor/bin/ece-tools module:refresh

  4. モジュールのステータスを確認します。

    code language-bash 
    bin/magento module:status <module-name>

  5. コードの変更を追加、コミットおよびプッシュします。

    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 のバージョンを確認してください。

拡張機能を更新するには:

  1. ローカルワークステーションで、をプロジェクトディレクトリに変更します。

  2. 開発ブランチを作成またはチェックアウトします。 ブランチを参照してください。

  3. composer.json ファイルをテキストエディターで開きます。

  4. 拡張機能を探して、バージョンを更新します。

  5. 変更を保存し、テキストエディターを終了します。

  6. プロジェクトの依存関係を更新します。

    code language-bash 
    composer update

  7. コードの変更を追加、コミット、プッシュします。

    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での拡張機能の使用について詳しくは、『 管理者ガイド 』の 拡張機能を参照してください。

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26