Skip to content

Commit dddd678

Browse files
fold error notifications into logging and drop the error handling page
1 parent 69eb5a3 commit dddd678

3 files changed

Lines changed: 17 additions & 10 deletions

File tree

docs/user-guide/error-handling.md

Lines changed: 0 additions & 9 deletions
This file was deleted.

docs/user-guide/logging.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,23 @@ in the PHP error log for it.
4646

4747
:::
4848

49+
## Errors reported as they happen
50+
51+
Your editor can also ask to be told about every diagnostic PHP raises — warnings,
52+
notices, deprecations and errors — as they occur. Each one arrives with its
53+
message, its file and its line, and the script keeps running.
54+
55+
This is the middle ground between the two extremes. Ignoring a warning means
56+
finding it later in a log, if at all; breaking on one, with an
57+
[exception breakpoint](./breakpoints.md#exception-breakpoints) on `Warning`, stops
58+
you dead every time it fires. A notification just tells you, in order, alongside
59+
everything else the request did.
60+
61+
Like output capture, this is an editor setting negotiated when the session starts,
62+
and it is off unless your editor asks for it. It is worth turning on and leaving
63+
on: a deprecation you would never have gone looking for is exactly the kind of
64+
thing that turns up in that panel.
65+
4966
## The debugger's own log
5067

5168
The debug log is for the times the debugger is the problem: the session never

sidebars.js

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,6 @@ const sidebars = {
3939
'user-guide/inspect-variables',
4040
'user-guide/watches-and-edits',
4141
'user-guide/logging',
42-
'user-guide/error-handling',
4342
],
4443
},
4544
{

0 commit comments

Comments
 (0)