PhpStorm サーバーの設定

PhpStorm IDE は、Xdebug で正しく動作するように設定する必要があります。

Xdebug と連携するように PhpStorm を設定するには:

  1. PhpStorm プロジェクトで、設定 パネルを開きます。

    • macOS - PhpStorm/設定 を選択します。
    • Windows/Linux - ファイル/設定 を選択します。
  2. 設定 パネルで「PHP」セクションを展開し、「サーバー」をクリックします。

  3. + をクリックして、サーバー設定を追加します。 プロジェクト名は、上部がグレーで表示されます。

  4. [ オプション ] 新しいサーバー設定に対して次の設定を行います。 PHPStorm ドキュメントの デバッグサーバーが設定されていませんを参照してください。

    • 名前 - ホスト名と同じ名前を入力します。 デバッグに CLI を使用するには、この値が Debug CLI コマンドPHP_IDE_CONFIG 変数の値と一致する必要があります。
    • ホスト - ホスト名を入力します。
    • ポート - 443 と入力します。
    • デバッガー - 「Xdebug」を選択します。
  5. パスマッピングを使用 を選択します。 ファイル/ディレクトリ ペインに、serverName のプロジェクトのルートが表示されます。

  6. サーバー上の絶対パス 列で 編集 アイコンをクリックし、環境に基づいて設定を追加します。

    • すべてのスターター環境および Pro 統合環境では、リモートパスは /app です。

    • ステージング環境および実稼動環境の場合:

      • 実稼動:/app/<project_code>/
      • ステージング:/app/<project_code>_stg/
  7. Xdebug ポートを 9000,9003 に変更するか、PHP/Debug/Xdebug/Debug Port パネルでポートを 9000 のみに制限できます。

  8. 適用 をクリックします。

PHPStorm Run/Debug 設定の作成

これにより、Adobe Commerce アプリケーションからのリクエストを処理するための適切なデバッグ設定をアプリケーションに指定できます。

  1. PHPStorm アプリケーションを開き、画面の右上にある Add Configuration をクリックします。

  2. Add new run configuration」をクリックします。

  3. PHP Remote Debug オプションを選択します。

    • 識別できる一意の名前を入力してください。
    • 「Filter debug connection by IDE key**」チェックボックスをオンにします。
    • 前の節で作成したサーバーを選択します。 まだ作成していない場合は、ここで作成できますが、設定ガイドのその部分を参照してください。
    • IDE key(session id)」テキストフィールドに、大文字で PHPSTORM と入力します。 これは設定の他の部分で使用するので、同じにしておくことが重要です。 別の文字列を選択する場合は、設定および設定プロセスの他の場所でも使用する必要があります。
  4. Apply/OK をクリックします。