PHP xdebug (dbgp) proxy

This is expandable dbgp xdebug proxy based on amphp.

The idea is described in the document Multi-user debugging in PhpStorm with Xdebug and DBGp proxy.

The main benefit is that this proxy is written in php - the language you know.

Installation

This package can be installed as a Composer project:

composer.phar create-project mougrim/php-xdebug-proxy

Or dependency:

composer.phar require mougrim/php-xdebug-proxy --dev

For parse XML you should install ext-dom.

For write logs by default you should install amphp/log (use --dev if you installed php-xdebug-proxy as dependency):

composer.phar require amphp/log '^1.0.0'

Run

You can run next command:

bin/xdebug-proxy

The proxy will be run with default config:

Using config path /path/to/php-xdebug-proxy/config
[2018-06-21 09:31:51] xdebug-proxy.NOTICE: [Proxy][IdeRegistration] Listening for new connections on '127.0.0.1:9001'... array ( ) array ( )
[2018-06-21 09:31:51] xdebug-proxy.NOTICE: [Proxy][Xdebug] Listening for new connections on '127.0.0.1:9002'... array ( ) array ( )

So by default proxy listens '127.0.0.1:9001' for ide registration connections and '127.0.0.1:9002' for xdebug connections.

Config

If you want to customize a logger, to configure your factory or logger, you can use custom config path. Just copy config directory to your custom path:

cp -r /path/to/php-xdebug-proxy/config /your/custom/path

There are 3 files:

• config.php:

  <?php
  return [
      'xdebugServer' => [
          // xdebug proxy server host:port
          'listen' => '127.0.0.1:9002',
      ],
      'ideServer' => [
          // if proxy can't find ide, then it uses default ide,
          // pass empty string if you want to disable default ide
          // defaultIde is useful when there is only one user for proxy
          'defaultIde' => '127.0.0.1:9000',
          // predefined ide list in format 'idekey' => 'host:port',
          // pass empty array if you don't need predefined ide list
          // predefinedIdeList is useful when proxy's users aren't changed often,
          // so they don't need to register in proxy each proxy restart
          'predefinedIdeList' => [
              'idekey' => '127.0.0.1:9000',
          ],
      ],
      'ideRegistrationServer' => [
         // host:port for register ide in proxy
          'listen' => '127.0.0.1:9001',
      ],
  ];

• logger.php: you can customize a logger, the file should return an object, which is instance of \Psr\Log\LoggerInterface;
• factory.php: you can customize classes, which are used in proxy, file should return object, which is instanceof Factory\Factory.

Then change configs and run:

bin/xdebug-proxy --configs=/your/custom/path/config

Extending

As mentioned above you can customize classes using your custom factory, which implements Factory\Factory. By default Factory\DefaultFactory factory is used.

The most powerful are the request preparers. You can override Factory\DefaultFactory::createRequestPreparers(). It should return an array of objects which implement RequestPreparer\RequestPreparer interface.

You can use request preparer for example for changing path to files (in break points and execution files).

Good example of the request preparer is RequestPreparer\SoftMocksRequestPreparer. You can see its usage in Factory\SoftMocksFactory.

Using with soft-mocks

See doc in soft-mocks project.

Thanks

Many thanks to Eelf for proxy example smdbgpproxy.

Thanks to Dmitry Ananyev for help with docs.