xdebug.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
    //
    // Debug a remote server:
    // SSH Forwarding Port 9002: `ssh -R 9002:localhost:9002 domain.com`
    // 
    // Debug a remote instance that expects you to be at a different IP address (docker use case, requires xdebug configuration)
    // sudo ifconfig en0 alias 10.254.254.254 255.255.255.0 
    // Set xdebug server configuration to connect to the remote address 10.254.254.254 on the 255.255.255.0 sub
    // Useful for when you must connect to a xdebug server running in a container network cluster, and you need the host
    // to connect to an IDE as a remote client
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            // "log": true,
            "request": "launch",
            "port": 9002,
            "pathMappings": {
                "/remote/path/on/server/specialfile.php": "${workspaceRoot}/src/path/specialfile.php",
                "/remote/path/directory": "${workspaceRoot}/src/path/directory",
            }
        }
    ]
}