Skip to content

Commit a911f4e

Browse files
reword intro sentence and shorten the cloud section
1 parent acf0711 commit a911f4e

1 file changed

Lines changed: 9 additions & 15 deletions

File tree

docs/user-guide/connecting-to-a-client.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Connecting to a Client
33
---
44

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.
77
Nothing listens on the PHP side, so there is no port to expose and nothing to let
88
through a firewall on the way in.
99

@@ -94,22 +94,16 @@ that much, which is why the default is small.
9494
Raise it if the connection has to cross a real network and 200 ms is not enough to
9595
complete a handshake — a few hundred more is usually plenty.
9696

97-
## Connecting through a relay
97+
## Connect using Xdebug Cloud
9898

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:
103102

104103
```ini
105104
php_debugger.cloud_id=your-id-here
106105
```
107106

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

Comments
 (0)