KO
|
EN
gitlite — search
Search
#python
#javascript
#typescript
#html
#nodejs
#react
#deep-learning
#flutter
#rust
#css
#diffusion-models
#ai
php-xdebug-proxy
★ 90
Open GitHub ↗
PHP xdebug (dbgp) proxy server
Download README (.md)
Explore Similar Repositories
mat-video
:
:tv: mat-video is an Angular 8/9+ video player using Material!
apollo-mocked-provider
:
Automatically mock GraphQL data with a mocked ApolloProvider
pdn-ddsfiletype-plus
:
A Paint.NET filetype plugin that adds support for some of the DDS formats introduced in DirectX 10 and later.
go-asyncapi
:
AsyncAPI spec from Go code
GmodDotNet
:
Cross-platform .NET Module/Plugin platform for Garry's Mod powered by .NET.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
php-xdebug-proxy
?
Download (.md)
## PHP xdebug (dbgp) proxy This is [expandable](#extending) [dbgp](https://xdebug.org/docs-dbgp.php) xdebug proxy based on [amphp](https://amphp.org/). The idea is described in the document [Multi-user debugging in PhpStorm with Xdebug and DBGp proxy](https://confluence.jetbrains.com/display/PhpStorm/Multi-user+debugging+in+PhpStorm+with+Xdebug+and+DBGp+proxy#Multi-userdebugginginPhpStormwithXdebugandDBGpproxy-HowdoesXdebugwork%3F). The main benefit is that this proxy is written in php - the language you know. [](https://packagist.org/packages/mougrim/php-xdebug-proxy) [](https://packagist.org/packages/mougrim/php-xdebug-proxy) [](https://packagist.org/packages/mougrim/php-xdebug-proxy) [](https://github.com/mougrim/php-xdebug-proxy/actions?query=branch%3Amaster) ### Installation This package can be installed as a [Composer](https://getcomposer.org/) project: ```bash composer.phar create-project mougrim/php-xdebug-proxy ``` Or dependency: ```bash 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): ```bash composer.phar require amphp/log '^1.0.0' ``` ### Run You can run next command: ```bash bin/xdebug-proxy ``` The proxy will be run with default config: ```text Using config path /path/to/php-xdebug-proxy/config [2019-02-14 10:46:24] xdebug-proxy.NOTICE: Use default ide: 127.0.0.1:9000 array ( ) array ( ) [2019-02-14 10:46:24] xdebug-proxy.NOTICE: Use predefined ides array ( 'predefinedIdeList' => array ( 'idekey' => '127.0.0.1:9000', ), ) array ( ) [2019-02-14 10:46:24] xdebug-proxy.NOTICE: [Proxy][IdeRegistration] Listening for new connections on '127.0.0.1:9001'... array ( ) array ( ) [2019-02-14 10:46:24] 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, use `127.0.0.1:9000` as default IDE and predefined IDE with key `idekey`. ### Config If you want to configure listening ports, etc., you can use custom config path. Just copy [`config`](config) directory to your custom path: ```bash cp -r /path/to/php-xdebug-proxy/config /your/custom/path ``` There are 3 files: - [`config.php`](config/config.php): ```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 // pass empty string if you want to disable ide registration 'listen' => '127.0.0.1:9001', ], ]; ``` - [`logger.php`](config/logger.php): you can customize a logger, the file should return an object, which is instance of `\Psr\Log\LoggerInterface`; - <a name="factory-php"></a>[`factory.php`](config/factory.php): you can [customize classes](#extending), which are used in proxy, file should return object, which is instanceof [`Factory\Factory`](src/Factory/Factory.php). Then change configs and run: ```bash bin/xdebug-proxy --configs=/your/custom/path/config ``` ### Extending As mentioned [above](#factory-php) you can customize classes using your custom factory, which implements [`Factory\Factory`](src/Factory/Factory.php). By default [`Factory\DefaultFactory`](src/Factory/DefaultFactory.php) 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`](src/RequestPreparer/RequestPreparer.php) interface. Request preparers will be called: - on request to ide from first to last - on request to xdebug from last to first 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`](src/RequestPreparer/SoftMocksRequestPreparer.php). You can see its usage in [`Factory\SoftMocksFactory`](src/Factory/SoftMocksFactory.php). ### Using with soft-mocks For soft-mocks you can use [`softMocksConfig`](softMocksConfig) config directory: ```bash bin/xdebug-proxy --configs=/path/to/php-xdebug-proxy/softMocksConfig ``` If you you want to provide path to custom `soft-mocks` init script, then copy [`softMocksConfig`](softMocksConfig) and change [`config.php`](softMocksConfig/config.php): ```php ... 'softMocks' => [ // if empty string, then vendor/badoo/soft-mocks/src/init_with_composer.php is used 'initScript' => '/your/custom/init-script.php', ], ... ``` For more information see doc in [soft-mocks](https://github.com/badoo/soft-mocks/#using-with-xdebug) project. ### Thanks Many thanks to [Eelf](https://github.com/eelf) for proxy example [smdbgpproxy](https://github.com/eelf/smdbgpproxy). Thanks to [Dmitry Ananyev](https://github.com/altexdim) for help with docs.
