|
2 | 2 | title: Connecting to a Client |
3 | 3 | --- |
4 | 4 |
|
5 | | -The connection is made by PHP, not by your editor. Your editor waits on a port, |
6 | | -and when a session starts the debugger reaches out to it and opens the connection. |
| 5 | +The connection is made by PHP, not by your editor. Your editor waits on a port and, |
| 6 | +when a session starts, the debugger reaches out to it and opens the connection. |
7 | 7 | Nothing listens on the PHP side, so there is no port to expose and nothing to let |
8 | 8 | through a firewall on the way in. |
9 | 9 |
|
@@ -94,22 +94,16 @@ that much, which is why the default is small. |
94 | 94 | Raise it if the connection has to cross a real network and 200 ms is not enough to |
95 | 95 | complete a handshake — a few hundred more is usually plenty. |
96 | 96 |
|
97 | | -## Connecting through a relay |
| 97 | +## Connect using Xdebug Cloud |
98 | 98 |
|
99 | | -`php_debugger.cloud_id` is for the case where the debugger cannot reach your |
100 | | -machine at all — the code runs behind a firewall or a NAT you do not control, and |
101 | | -no address you set would connect. Instead of dialing your editor, the debugger |
102 | | -dials a hosted relay, and your editor connects to the same relay from its side. |
| 99 | +When the debugger cannot reach your machine at all — the code runs behind a |
| 100 | +firewall or a NAT you do not control — Xdebug Cloud can relay the session instead. |
| 101 | +Set the ID it gives you: |
103 | 102 |
|
104 | 103 | ```ini |
105 | 104 | php_debugger.cloud_id=your-id-here |
106 | 105 | ``` |
107 | 106 |
|
108 | | -The ID comes from the relay service, and both ends must use it. Setting it takes |
109 | | -priority over `client_host` — leave it empty, as it is by default, and connections |
110 | | -stay direct. Unlike the other settings on this page, it can only be set in |
111 | | -`php.ini`. |
112 | | - |
113 | | -The relay is a third-party, paid service; see |
114 | | -[its documentation](https://xdebug.org/docs/cloud) for what it costs and how to get |
115 | | -an ID. |
| 107 | +Setting it takes priority over `client_host`, and unlike the other settings on this |
| 108 | +page it can only be set in `php.ini`. See the |
| 109 | +[Xdebug Cloud documentation](https://xdebug.org/docs/cloud) for how to get an ID. |
0 commit comments