feat: Control socket (#1078)

* Control socket pause.

* Refactor control socket and support win32 and linux.

* Use provided control socket path in init packet.

* Update Xdebug version.

* Force close control socket.

* Remove deprecated abstract socket package. Generalize linux and windows ctrl socket routines.

* Update package lock.

* Reflect changes in Xdebug. The control socket attribute does not have \\.\pipe\ anymore.

* Get package-lock.json from main

* Remove abstract-socket.d.ts

* Update Linux abstract UNIX socket name.

* npm audit fix

* Update CHANGELOG.md

* Add command to find and pause a PHP process.

* Support listing control sockets on linux

* Control Socket test file

* Prettier

* Skip tests for macos, implement progress indicator...

* Docs.

Author: zobo

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [1.39.0]
+
+- Xdebug control socket support for pause on Linux and Windows (Xdebug 3.5).
+
 ## [1.38.2]
 
 - Fix problematic evaluate changes

README.md

@@ -125,6 +125,7 @@ Options specific to CLI debugging:
 - Run without debugging
 - DBGp Proxy registration and unregistration support
 - Xdebug Cloud support
+- Xdebug Control Sockets
 
 ## Remote Host Debugging
 
@@ -150,6 +151,16 @@ The official implementation of the [dbgpProxy](https://xdebug.org/docs/dbgpProxy
 
 A _Xdebug helper_ browser extension is also recommended. There the request side IDE key can be easily configured.
 
+## Xdebug Control Sockets
+
+With Xdebug 3.5+, a new feature enables IDEs to trigger pauses in PHP execution. This extension supports Xdebug Control Sockets in two ways:
+
+1. **Pause during active debugging**: The _pause_ button triggers a control socket pause command, allowing you to pause PHP execution even in loops without breakpoints.
+
+2. **Pause any PHP process**: The VS Code command `Pause PHP process (Xdebug Control Socket)` lists all PHP Control Sockets on your system, letting you pause any process or initiate a debug connection. Ensure the debugger is listening for incoming connections.
+
+For setup instructions, see the [Xdebug control_socket documentation](https://xdebug.org/docs/step_debug#control_socket).
+
 ## Troubleshooting
 
 - Ask a question on [StackOverflow](https://stackoverflow.com/questions/tagged/xdebug)