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

PaaS のみ

アプリケーションモード

最終更新日: 2025年5月5日
  • トピック:
  • 設定

作成対象:

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

Commerce アプリケーションは、次のいずれかの モード で実行できます。

モード名説明クラウドサポート
デフォルト設定を変更せずに、1 台のサーバーにCommerce アプリケーションをデプロイして実行します。 なし 実稼動用に最適化されます。なし
開発者Commerce アプリケーションの拡張またはカスタマイズ時の開発に最適です。なし
実稼動Commerce アプリケーションを実稼動システムにデプロイして実行します。はい
メンテナンス更新および構成の実行中にサイトにアクセスできないようにします。はい

Adobe Commerceのオペレーションモードを手動で変更する方法については、 オペレーションモードの設定を参照してください。

クラウドサポート

読み取り専用ファイルシステムにより、リモートクラウド環境のモードを変更することには厳密な制限があり、Adobe Commerce サポートによって上書きすることはできません。 ece-tools パッケージが複数の設定ソースに基づいたファイルを上書きするので、app/etc/env.php ファイルを変更してモードを変更しようとしないでください。

クラウドインフラストラクチャー上のAdobe Commerceでは、デプロイメント中にアプリケーションを自動的に メンテナンス モードで実行します。これにより、デプロイメントが完了するまでサイトがオフラインになります。 それ以外の場合、アプリケーションは 実稼動 モードのままになります。 2}Cloud Infrastructure 上のCommerce ガイドの { デプロイメントプロセス } を参照してください 。

Cloud Docker for Commerceを開発ツールとして使用する場合、Docker 環境に developer モードでクラウドインフラストラクチャプロジェクトをデプロイできますが、ファイル同期処理が増えるため、パフォーマンスが低下します。 Cloud Docker for Commerce ガイド 🔗 の Docker 環境のデプロイ を参照してください。

デフォルトモード

デフォルト モードを使用すると、設定を変更せずに 1 台のサーバーにCommerce アプリケーションをデプロイできます。 ただし、静的ファイルのパフォーマンスが低下するので、デフォルトのモードは実稼動用に最適化されません。 静的ファイルの作成とキャッシュは、静的ファイル作成ツールを使用して生成する場合よりもパフォーマンスに大きな影響を与えます。

デフォルトモード:

  • 例外は、表示ではなくログファイルに書き込まれます
  • 静的ビューファイルはキャッシュされる
  • カスタム X-Magento-* HTTP リクエストヘッダーと応答ヘッダーを非表示にします

他のモードが指定されていない場合、Commerceはデフォルトモードで動作します。

開発者モード

Commerce アプリケーションを拡張およびカスタマイズする場合は、developer モードをお勧めします。 静的ビューファイルはキャッシュされませんが、オンデマンドで pub/static ディレクトリに書き込まれます。

開発者モードの場合:

  • 自動コード コンパイルおよび拡張デバッグを有効にします。
  • キャッチされなかった例外がブラウザーに表示される
  • var/report のシステム ログは詳細です
  • エラーハンドラーで、ログではなく例外がスローされる
  • イベント サブスクライバーを呼び出せない場合に例外がスローされます
  • カスタム X-Magento-* HTTP リクエストヘッダーと応答ヘッダーを表示します
NOTE
このモードはAdobe Commerce Cloud環境ではサポートされず、Adobe Commerce サポートはアプリケーションモードの変更を容易にできません。

実稼動モード

実稼動 モードは、Commerce アプリケーションを実稼動システムにデプロイする場合に最適です。 データベースや web サーバーなどのサーバー環境を最適化した後、 静的表示ファイル配置ツールを実行して、静的表示ファイルを pub/static ディレクトリに書き込む必要があります。 これにより、Commerce アプリケーションが実行時に静的ファイルをオンデマンドで動的に見つけてコピー(マテリアライズ)するのではなく、デプロイメント時に必要なすべての静的ファイルを提供することで、パフォーマンスが向上します。

管理の詳細および開発者システム設定セクションなどの一部のフィールドは、実稼動モードでは使用できません。 例えば、Admin を使用してキャッシュタイプを有効または無効にする はできません。 コマンドラインを使用して、キャッシュタイプ のみ を有効または無効にできます。

実稼動モードの場合:

  • 静的ビューファイルは、キャッシュからのみ提供されます
  • エラーと例外はファイルシステムに記録され、ユーザーには表示されません
  • 管理者の一部の設定フィールドは使用できません

メンテナンスモード

メンテナンス モードは、改善、更新、設定タスクの間、サイトへのアクセスを制限または禁止します。 デフォルトでは、サイトは訪問者をデフォルトの Service Temporarily Unavailable ページにリダイレクトします。

カスタムメンテナンスページを作成し、メンテナンスモードを手動で有効または無効にしたり、メンテナンスモードを設定して、許可された IP アドレスからの訪問者がストアを正常に表示できるようにすることができます。 『インストールガイド の「メンテナンスモードの有効化と無効化を参照してください __。

クラウドインフラストラクチャー上でCommerceを使用している場合、Commerce アプリケーションはデプロイフェーズ中にメンテナンスモードで実行されます。 デプロイメントが正常に完了すると、Commerce アプリケーションは実稼動モードの実行中に戻ります。 2}Cloud Infrastructure 上のCommerce ガイドの {Deployment hook} を参照してください 。

メンテナンスモードの場合:

  • サイト訪問者はデフォルトの Service Temporarily Unavailable ページにリダイレクトされる
  • var/ ディレクトリには、.maintenance.flag ファイルが含まれています
  • IP アドレスに基づいて訪問者のアクセスを制限できます
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c