拡張機能の管理

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

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

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

このセクションでは、Commerce Marketplaceから Composer 名と拡張機能のバージョンを取得する方法について説明しますが、 いずれか モジュールの Composer ファイル内のモジュール。 を開きます 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 の名前とバージョンを使用して、拡張機能をに追加します require の節 composer.json ファイル。

    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-terminal
    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