WordPress Studio での Xdebug の使用

このテキストはAIを使用して翻訳されました。英語の原文を表示するには、こちらをクリックしてください。

Xdebug は PHP 用のデバッグ拡張機能で、ブレークポイントの設定、変数の検査、コードのステップ実行が可能です。WordPress Studio には Xdebug のサポートが含まれており、WordPress Playground の WebAssembly 版 PHP を利用しています。

Xdebug を有効にする

1. デバッグしたいサイトを選択します。
2. 「設定」タブに移動します。
3. 「サイトを編集」をクリックします。
4. 「Xdebug を有効にする」チェックボックスにチェックを入れます。
5. 「保存」をクリックします。

サイトは Xdebug が有効な状態で自動的に再起動します。

重要な制限事項

• 一度に1つのサイトのみ：Xdebug は一度に1つのサイトでのみ有効にできます。別のサイトで有効にするには、まず現在のサイトで無効にする必要があります。
• パフォーマンスへの影響：Xdebug はサイトのパフォーマンスを低下させる場合があります。デバッグを行っていないときは無効にしてください。

IDE で Xdebug を使用する

サイトで Xdebug を有効にすると、IDE（コードエディター）を接続して WordPress のプラグイン、テーマ、コアコードをデバッグできます。

Visual Studio Code のセットアップ

1. PHP Debug 拡張機能をインストールします。
2. プロジェクト内に以下の設定で .vscode/launch.json ファイルを作成します：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/wordpress": "${workspaceFolder}"
      }
    }
  ]
}

3. コード内にブレークポイントを設定します。
4. Visual Studio Code でデバッグセッションを開始します（実行 → デバッグの開始）。
5. ブラウザーでサイトにアクセスし、ブレークポイントをトリガーします。

PhpStorm のセットアップ

1. Settings（設定） → PHP → Debug（デバッグ） に移動します。
2. Xdebug のポートが 9003 に設定されていることを確認します。
3. 最初の行で停止しないようにするには：
   • 「Force break at first line when no path mapping specified（パスマッピングが指定されていない場合、最初の行で強制的に停止する）」を無効にします
   • 「Force break at first line when a script is outside the project（スクリプトがプロジェクト外にある場合、最初の行で強制的に停止する）」を無効にします
4. Settings（設定） -> PHP → Servers（サーバー） に移動し、サイトのサーバーのマッピングを設定します：
   • Host: localhost:8884
   • Port: 80
   • File directory: /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server: /wordpress
5. ツールバーから「Start listening for PHP Debug Connections（PHP デバッグ接続のリッスンを開始）」を有効にします。
6. コード内にブレークポイントを設定します。
7. ブラウザーでサイトにアクセスし、ブレークポイントをトリガーします。

詳細情報

Xdebug 統合に関する追加情報については、WordPress Playground Xdebug ドキュメントを参照してください。