ドキュメントCommerce設定ガイド

[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

システム設定の作成

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 経験者
  • 管理者
  • 開発者

次の要件を満たすビルドシステムを 1 つ用意できます。

  • すべてのCommerce コードは、開発システムおよび実稼働システムと同じリポジトリでソース管理下にあります

  • 次のすべてがソース管理に含まれている 含まれている ことを確認します。

    • app/etc/config.php
    • generated ディレクトリ（およびサブディレクトリ）
    • pub/media ディレクトリ
    • pub/media/wysiwyg ディレクトリ（およびサブディレクトリ）
    • pub/static ディレクトリ（およびサブディレクトリ）

  • 互換性のある PHP バージョンがインストールされている必要があります

  • Composer がインストールされている必要があります。

  • ​ 開発、ビルド、実稼働システムの前提条件 ​ で説明されているように、ファイルシステムの所有権と権限が設定されています。

  • ビルドシステムではCommerceをインストールする必要はありませんが、コードを使用できる必要があります。

WARNING
config.php に既に含まれている場合は、データベース接続は必要ありません。​ 設定のエクスポート ​ を参照してください。 それ以外の場合は、データベース接続が必要です。
INFO
ビルドマシンは、独自のホスト上か、インストールされているCommerce システムと同じホスト上に存在できます。

ビルドマシンの設定

次の節では、ビルドマシンの設定方法について説明します。

Composer のインストール

まず、Composer がすでにインストールされているかどうかをチェックします。

コマンドプロンプトで、次のいずれかのコマンドを入力します。

  • composer --help
  • composer list --help

コマンド ヘルプが表示された場合、Composer はすでにインストールされています。

エラーが表示された場合は、以下の手順で Composer をインストールします。

Composer をインストールするには：

  1. をCommerce サーバー上の空のディレクトリに移動または作成します。

  2. 次のコマンドを入力します。

    code language-bash 
    curl -sS https://getcomposer.org/installer | php
    code language-bash 
    mv composer.phar /usr/local/bin/composer

その他のインストール オプションについては、「Composer インストール ドキュメント」を参照してください。

PHP のインストール

CentOS または Ubuntu に PHP をインストールします。

ビルドシステムの設定

ビルドシステムを設定するには：

  1. ファイルシステムの所有者としてビルドシステムにログインするか、所有者に切り替えます。

  2. ソース管理からCommerce コードを取得します。

    Git を使用する場合は、次のコマンドを使用します。

    code language-bash 
    git clone [-b <branch name>] <repository URL>

  3. Commerceのルートディレクトリに移動して、次のように入力します。

    code language-bash 
    composer install

  4. 依存関係が更新されるのを待ちます。

  5. 所有権の設定：

    code language-bash 
    chown -R <Commerce file system owner name>:<web server username> .

    以下に例を挙げます。

    code language-bash 
    chown -R commerce-username:apache .

  6. Git を使用している場合は、.gitignore をテキストエディターで開きます。

  7. 次の各行を # 文字で開始して、コメント化します。

    code language-conf 
    # app/etc/config.php
# pub/media/*
# generated/*
# pub/media/*.*
# pub/media/wysiwyg/*
# pub/static/*

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

  9. Git を使用する場合は、次のコマンドを使用して変更をコミットします。

    code language-bash 
    git add .gitignore && git commit -m "Modify .gitignore for build and production"

    詳しくは .gitignore リファレンスを参照してください。

  10. ビルドシステムでは、​ デフォルトモード ​ または ​ 開発者モード ​ を使用する必要があります。

    code language-bash 
    bin/magento deploy:mode:set <mode>

    <mode> が必要です。 default または developer のいずれかです。

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c