vscode:PHPデバッグ設定項目にpathMappingが間違うとブレイクポイントに止まらない

vscodeのPHPデバッグ設定

• php.iniファイルに、XDebugをを以下のように設定します

  [XDebug]
  zend_extension = "D:\develop\servers\xampp-5.6.15\php-7.2.30-Win32-VC15-x86\ext\php_xdebug-2.9.5-7.2-vc15.dll"
  xdebug.remote_enable = on
  xdebug.remote_autostart = on
  xdebug.remote_handler = "dbgp"
  xdebug.remote_host = "127.0.0.1"
  xdebug.remote_port = 9000
  xdebug.remote_log="D:\develop\servers\xampp-5.6.15\tmp\xdebug.log"
  xdebug.max_nesting_level=1000

• phpinfo()関数で、XDebugを確認
  
• vscodeのエクステンションから「php」キーワードで検索すると「PHP Debug」がありまして、これをインストールします
  
• vscodeの左側にRunというアイオンをクリックして、launch.json設定画面を開き、デバッグの設定を行います

  {
      // Use IntelliSense to learn about possible attributes.
      // Hover to view descriptions of existing attributes.
      // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
      "version": "0.2.0",
      "configurations": [
          {
              "name": "2drill.local",
              "type": "php",
              "request": "launch",
              "port": 9000,
              "stopOnEntry":false,
              "pathMappings": {
                  "${workspaceRoot}": "${workspaceRoot}"
              }
          },
          {
              "name": "Launch currently open script",
              "type": "php",
              "request": "launch",
              "program": "${file}",
              "cwd": "${fileDirname}"
          }
      ]
  }

  

• 「Start Debugging」アイコンをクリックすると、PHPのデバッガーが開始し、ブラウザでリモートサイトにアクセスすれば、デバッグができるようになります

launch.jsonでの設定が間違うとデバッカーが起動できないか、ブレイクポイントに止まらない

• phpのデバッグの設定にいくつかの注意点あります
• パラメーター： pathMappings
  • ローカルPCでデバッグするときに、 リモートサーバー／ローカルソースコードが同じところにあるため、このパラメーターの設定はなくてもよいです
  • あるいは以下のように設定してもよいです

    "pathMappings": {
         "${workspaceRoot}": "${workspaceRoot}"
    }

  • ネット上にいろいろな詳細の具体的にリモート／ローカルソースパスを設定して、運が良ければデバッカーが起動後に、ソースコードのExceptionが発生するところに止まりますが、ブレイクポイントに止まらない現象があります
    
  • 上記現況では、デバッカーが正常に動作しているように見えますが、実際にブレイクポイントに止まらないです。デバッカーが正常に動作していません
• パラメーター：port（初期値は9000）
  • php.iniのデバッグ設定：xdebug.remote_port = 9000
  • launch.jsonとpho.iniのポートを合わせる必要があります
  • もしほかのソフトウェア（例：NetBeans）が既に9000を使用したら、ここで別のポート番号を変更する必要があります。ポート番号を変更しないと、デバッカーがブレイクポイントに止まらないようです
• パラメーター：host
  • ホストの設定がなければ、デバッカーが全IPを対応します
  • ほぼ、hostの設定の必要はありません