ドキュメントCommerceCommerce on Cloud

拡張機能を管理

最終更新日： 2026年6月2日

作成対象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

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

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

この節では、Commerce Marketplaceから拡張機能のコンポーザー名とバージョンを取得する方法について説明しますが、any モジュールの名前とバージョンは、モジュールのコンポーザーファイルにあります。 composer.json ファイルをテキストエディターで開き、"name"と"version"の値を書き留めます。

Commerce Marketplace​からモジュールのコンポーザー名を取得するには：

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

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

    ​ マーケットプレイスアカウントにアクセス ​

  3. 自分のアカウント ページで、自分の購入履歴​をクリックします。

    ​ マーケットプレイス購入履歴

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

拡張機能のアップグレード

続行する前に、拡張機能のコンポーザー名とバージョンが必要です。 また、拡張機能がプロジェクトと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
commerce-on-cloud-help-cloud-guide