feat(debug): debug programs in a plugin run target (#2264)

2026-11-09 11:15:40 +02:00 · 2026-11-09 12:52:41 +08:00
@@ -2484,3 +2484,19 @@ The virtual URI identifies its originating server, including for document links
 and diagnostic-related locations. Navigation inside these documents returns to
 that server; editing and saving
 are disabled. No WIT signature change is needed for this opt-in host setting.
+
+### Debugging run targets
+
+Plugin targets require `container-root` for debugging. PHP uses `connect-back`: the
+IDE runs php-debug on the host (on the SSH server for remote projects), listens on
+port 9003 unless configured otherwise, then starts the program through the normal
+target run path. The target must enable Xdebug debug mode and request startup, and
+set `xdebug.client_host` and `xdebug.client_port` to reach that listener. DDEV normally
+provides the host setting; enable its Xdebug support before debugging.
+
+Python uses `adapter-in-target`: the wrapper starts `python3 -m debugpy.adapter`
+over stdio. Install debugpy in that container interpreter; no host installation is
+used. The wrapper must preserve stdin/stdout and forward environment as needed.
+Project paths and DAP sources map between the project root and `container-root`.
+Other debuggers default to unsupported: Node and Go adapters currently require
+additional ports and have no supported stdio target configuration.
@@ -1 +1 @@
-34bea4bf36b7a814dafe02aaee02fe3354a667d1c8ca66f238de00322d0a035a
+e3c11d8969a1b8b52e7e745b558d12f804ebf533e7f0f3fe614ffe6f7b9c9468
@@ -1 +1 @@
-fdd68915997803652ad6f5c549107b043b9001ad4e176d2473d9b37469fbe1cc
+b28ccfd442c6348e0826680ec97391cbe4ec6a93a27ff02e40f47341e21586b4
@@ -1 +1 @@
-ad3fe934d30b48d53097bf4dee36a091b2410c0325924702c66e717405b58203
+d669a2600b0c59e91ac8a9b875a24bddf0eeddd404ce7b67da31733861a846b8
@@ -1 +1 @@
-5710601823307d167805a7ca20e7498fb9c37082b20df7fd1f86e1cd66b438f3
+a5f0ebce6d30e0dc03769ebe5cb82d3704c5ccc32207aa2b3f5500de7b1a9152
@@ -1 +1 @@
-1a486ceda9986bc253a0098c983f755c8860e6b7a3f2d7f0284b3b928b4e6c9e
+ee3ccb648ca4b98a0359521c4cd895b5e7336fd65101563f2ca82b8cbaeedc3d
@@ -1 +1 @@
-13f27c819384f92e406bf7226a46d3fe5b063e850db3d64916e661e1a63f345a
+51f7167dd5ed21ed37e227bd3b100a5be5a57e7890a494c942fdd036b1307993
@@ -1 +1 @@
-c7b2b471f26201c037522ee4a5b086d1c8ef88fbbb3f11f7279ad1a7185bdbae
+cd860e7a652951aaa42029da23fdeee7a3c09ab1bfcbfb0d1bb6c89036fc8817
@@ -1 +1 @@
-82c71af4a1f771dbd16a4c8f71b9bd6a6a53d82bd92958d4862467237b82d228
+db3ee94b5cf4234cee7d61e08a9f8629d7e7f6adbf11208b54cd4ea44cf1fc13
@@ -1 +1 @@
-65096a9b6331af9d40049801547e99e2fa1d5ae0f1065f6931af0aee8d2f24a7
+76d13e772046b192485ea59c7720177b563986e0167475c449a9a5c7430ef908
@@ -1 +1 @@
-cf8d21da412fd64f1f42c72b13be762ff1bcd43dd19965fc1fce805c5e1012ae
+a22c9e7ebf79b2d5926424a028edc09aef40293db9ebc959d9ececa1f0ebe4ca
@@ -1 +1 @@
-1ea1d7116e6b943e42580e43cb13199b6e48fc5acdf9784c4864adb7433ebb59
+fcc3d666fd1e89363fa8668dd10f89efc49f2376766282b734de4b719fdc9aff
@@ -1 +1 @@
-05ff46a6c1af09b84f9a931d8956d79fbad9507dcff708ba021e074c55c062e2
+2eb742315f877e3251f992884160ed4d9a2940ee12a7d4d7a52669238d495930
@@ -1 +1 @@
-26e57f5294b40bc31d9283843b2fcf6ad09d475fd160d61ddd3d420e54880a24
+c2feb6a4cd0e9908f078a3d0074732cfce653cc57cce9d1907838598515048ee
@@ -1 +1 @@
-0d2c1140fe718d06e08af903ee94bfe87cd04de77c1299f6f5c337042c6f6197
+590b46034f6c39592a27cabd5b0b76809e7f7133d258f322604614ecb3479317
@@ -1 +1 @@
-f4251a1cad1d5cea54559baca12d84fdf175e65db85ee3f4d29e381e045c40fb
+0d068ea0f0851e6e3166af0a91f290da8dc3f4a852b86050e7f7ced214a39124