Xdebug の設定

ローカルターミナルで、を開きます .magento.app.yaml ファイルをテキストエディターで開きます。

が含まれる runtime セクション、 extensions、追加： xdebug. 例：

runtime:
    extensions:
        - redis
        - xsl
        - newrelic
        - sodium
        - xdebug

変更をに保存します。 .magento.app.yaml ファイルを開き、テキストエディターを終了します。

変更を追加、コミットおよびプッシュして、環境を再デプロイします。

git add -A

git commit -m "Add xdebug"

git push origin <environment-ID>

PhpStorm プロジェクトで、 設定 パネル。

• macOS – 選択 PhpStorm > 環境設定.
• Windows/Linux – 選択 ファイル > 設定.

が含まれる 設定 パネルで、を展開して見つけます。 言語とフレームワーク > PHP > サーバー セクション。

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

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

• 名前— ホスト名と同じ値を入力します。 この値は、の値と一致する必要があります PHP_IDE_CONFIG 変数 Debug CLI コマンド をクリックします。
• ホスト— ホスト名を入力します。
• ポート—Enter 443.
• デバッガー – 選択 Xdebug.

を選択 パスマッピングの使用. が含まれる ファイル/ディレクトリ ペインに変更します。ここでは、 serverName が表示されます。

が含まれる サーバーの絶対パス 列で、 編集 アイコンをクリックし、環境に基づいて設定を追加してください。

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

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

  • 実稼動： /app/<project_code>/
  • ステージング： /app/<project_code>_stg/

変更： Xdebug の 9000 への移植 言語とフレームワーク > PHP > デバッグ > Xdebug > デバッグポート パネル。

クリック 適用.

ターミナルを開きます。

SSH を使用して接続を確立します。

ssh -R 9000:localhost:9000 <ssh url>

の使用 -v （verbose） オプションを指定すると、転送されるポートにソケットが接続されるたびに、端末に表示されます。

「接続できません」または「リモートのポートをリッスンできませんでした」というエラーが表示される場合は、ポート 9000 を占有しているサーバー上に、別のアクティブな SSH セッションが存在している可能性があります。 その接続が使用されていない場合は、終了できます。

SSH を使用して、リモート統合、ステージング、または実稼動環境にログインします。

SSH セッションのリストを表示します。 who

ユーザー別の既存の SSH セッションを表示します。 自分以外のユーザーに影響を与えないように注意してください。

• 統合：ユーザー名は次に似ています dd2q5ct7mhgus
• ステージング：ユーザー名は次に似ています dd2q5ct7mhgus_stg
• 実稼働：ユーザー名は次に似ています dd2q5ct7mhgus

ユーザーセッションが以前の場合、次のような擬似端末（PTS）値を見つけます。 pts/0.

PTS 値に対応するプロセス ID （PID）を強制終了します。

ps aux | grep ssh
kill <PID>

応答の例：

dd2q5ct7mhgus        5504  0.0  0.0  82612  3664 ?      S    18:45   0:00 sshd: dd2q5ct7mhgus@pts/0

接続を終了するには、プロセス ID （PID）を指定して kill コマンドを入力します。

kill 3664

まだ行っていない場合は、次をダウンロードします パテ.

パテを起動します。

カテゴリ ウィンドウで、 Session.

次の情報を入力します。

• ホスト名（または IP アドレス） フィールド： SSH URL クラウドサーバーの場合
• ポート フィールド：Enter 22

が含まれる カテゴリ ウィンドウで、をクリック 接続 > SSH > トンネル.

次の情報を入力します。

• ソースポート フィールド：Enter 9000
• 宛先 フィールド：Enter 127.0.0.1:9000
• クリック リモート

クリック 追加.

が含まれる カテゴリ ウィンドウで、をクリック Session.

が含まれる 保存済みセッション フィールドに、この SSH トンネルの名前を入力します。

クリック 保存.

SSH トンネルをテストするには、 ロード ​を選択し、 開く.

「接続できません」というエラーが表示される場合は、次の点を確認してください。

• Putty の設定はすべて正しい
• クラウドインフラストラクチャ上のプライベートAdobe Commerceの SSH キーがあるマシンで Putty を実行しています

ターミナルを開きます。

クラスターの各 web ノードに対するすべての SSH セッションをクリーンアップします。

ssh USERNAME@CLUSTER.ent.magento.cloud 'rm /run/platform/USERNAME/xdebug.sock'

クラスターの各 web ノードに対して、Xdebug 用の SSH トンネルを設定します。

ssh -R /run/platform/USERNAME/xdebug.sock:localhost:9000 -N USERNAME@CLUSTER.ent.magento.cloud

リモートデバッグを有効にします。ブラウザーでサイトにアクセスし、URL に次の内容を追加します。この URL は次のとおりです。 KEY の値である xdebug_key.

?XDEBUG_SESSION_START=KEY

この手順では、ブラウザーリクエストをトリガーに送信する Cookie を設定します Xdebug.

を使用したデバッグの完了 Xdebug.

セッションを終了する準備が整ったら、次のコマンドを使用して cookie を削除し、ブラウザーによるデバッグを終了します。このコマンドは次のとおりです。 KEY の値である xdebug_key.

?XDEBUG_SESSION_STOP=KEY

CLI コマンドを使用して、デバッグ対象のサーバに SSH で接続します。

次の環境変数を作成します。

export XDEBUG_CONFIG='PHPSTORM'

export PHP_IDE_CONFIG="serverName=<name of the server that is configured in PHPSTORM>"

これらの変数は、SSH セッションが終了すると削除されます。

デバッグの開始

スターター環境と Pro 統合環境では、CLI コマンドを実行してデバッグします。
次のような実行時オプションを追加できます。

php -d xdebug.profiler_enable=On -d xdebug.max_nesting_level=9999 bin/magento cache:clean

ステージング環境および実稼動環境では、へのパスを指定する必要があります Xdebug CLI コマンドのデバッグ時の PHP 設定ファイル。例：

php -c /etc/platform/USERNAME/php.xdebug.ini bin/magento cache:clean

日 拡張機能 メニュー、クリック デバッグ を有効にします。

右クリックして「オプション」メニューを選択し、IDE キーをに設定します。 PHPSTORM.

のインストール Xdebug ブラウザー上のクライアント。 を設定して有効にします。

を作成 SSH トンネル をクラウドサーバーに送信します。

のインストール Xdebug Helper 拡張機能 Chrome ストアから。

Chrome で拡張機能を有効にします（下図を参照）。

Chrome では、Chrome ツールバーの緑のヘルパーアイコンを右クリックします。

ポップアップメニューから、 オプション.

から IDE キー リスト、クリック PhpStorm.

クリック 保存.

PhpStorm プロジェクトを開きます。

上部のナビゲーションバーで、 リスニングを開始 アイコン。

ナビゲーション バーが表示されない場合は、 表示 > ナビゲーションバー.

PhpStorm のナビゲーションペインで、テストする PHP ファイルをダブルクリックします。

SSH を使用してリモート環境にログインします。

ファイルを圧縮します。

tar -czf /tmp/<file-name>.tgz <directory list>

例えば、 vendor ディレクトリのみ：

tar -czf /tmp/vendor.tgz vendor

ローカル環境では、PhpStorm を使用してファイルを圧縮します。

cd <phpstorm project root dir>

rsync <SSH-URL>:/tmp/<file-name>.tgz .

tar xzf <file-name>.tgz