Add XDEBUG_MODE=off to all DDEV commands to fix Xdebug hang issue

Co-authored-by: dermatz <6103201+dermatz@users.noreply.github.com>

Author: Copilot

README.md

@@ -138,6 +138,18 @@ PHPStan uses different exit codes to indicate different states:
 
 The extension handles exit codes 0 and 1 as successful execution, only treating exit code 2 and higher as actual failures.
 
+### Xdebug compatibility
+
+The extension automatically disables Xdebug for PHPStan analysis commands to prevent performance issues and hangs. When Xdebug is enabled in your DDEV container for debugging web requests, it can significantly slow down or cause CLI commands like PHPStan to hang.
+
+The extension uses `XDEBUG_MODE=off` when executing PHPStan commands, which:
+- Prevents Xdebug from interfering with PHPStan analysis
+- Improves analysis performance
+- Avoids timeout issues when Xdebug is waiting for a debugger connection
+- Does not affect your web debugging configuration
+
+This is handled automatically and requires no configuration on your part.
+
 ### No issues detected
 
 PHPStan might not find issues if:

src/extension.ts

@@ -197,7 +197,7 @@ function debugAnalyzeCurrentFile() {
         // Show output in a new document
         vscode.workspace.openTextDocument({
             content: `PHPStan Debug Output for: ${relativePath}\n` +
-                    `Command: ddev exec ${command}\n` +
+                    `Command: XDEBUG_MODE=off ddev exec ${command}\n` +
                     `Output length: ${output.length} characters\n` +
                     `${'='.repeat(80)}\n\n` +
                     output,

src/shared/utils/ddev-utils.ts

@@ -64,7 +64,7 @@ export class DdevUtils {
      */
     public static isDdevRunning(workspacePath: string): boolean {
         try {
-            execSync('ddev exec echo "test"', {
+            execSync('XDEBUG_MODE=off ddev exec echo "test"', {
                 cwd: workspacePath,
                 stdio: 'ignore'
             });
@@ -83,7 +83,7 @@ export class DdevUtils {
      */
     public static isToolInstalled(toolName: string, workspacePath: string): boolean {
         try {
-            execSync(`ddev exec ${toolName} --version`, {
+            execSync(`XDEBUG_MODE=off ddev exec ${toolName} --version`, {
                 cwd: workspacePath,
                 stdio: 'ignore'
             });
@@ -112,7 +112,7 @@ export class DdevUtils {
 
         // Try to run the tool
         try {
-            execSync(`ddev exec ${toolName} --version`, {
+            execSync(`XDEBUG_MODE=off ddev exec ${toolName} --version`, {
                 cwd: workspacePath,
                 stdio: 'ignore'
             });
@@ -188,7 +188,9 @@ export class DdevUtils {
      */
     public static execDdev(command: string, workspacePath: string, allowedExitCodes: number[] = [0]): string {
         try {
-            return execSync(`ddev exec ${command}`, {
+            // Disable Xdebug for CLI commands to prevent hangs and performance issues
+            // when Xdebug is enabled in the DDEV container
+            return execSync(`XDEBUG_MODE=off ddev exec ${command}`, {
                 cwd: workspacePath,
                 encoding: 'utf-8'
             });
@@ -206,7 +208,7 @@ export class DdevUtils {
             (enhancedError as any).status = error.status;
             (enhancedError as any).stderr = error.stderr;
             (enhancedError as any).stdout = error.stdout;
-            (enhancedError as any).command = `ddev exec ${command}`;
+            (enhancedError as any).command = `XDEBUG_MODE=off ddev exec ${command}`;
             (enhancedError as any).workspacePath = workspacePath;
 
             throw enhancedError;