Use the controls in this area to configure debugging using the Xdebug tool.
Debug port: in this field, specify the port for IntelliJ IDEA and the Xdebug engine to communicate through.
This must be the same port number as specified in the php.ini file:
xdebug.remote_port="<the port (9000 by default) to which Xdebug connects>"
By default, Xdebug 2 listens on port 9000. For Xdebug 3, the default port has changed from 9000 to 9003. You can specify several ports by separating them with a comma. By default, the Debug port value is set to 9001,9003 to have IntelliJ IDEA listen on both ports simultaneously.
Can accept external connections: select this checkbox to enable IntelliJ IDEA to accept any incoming connections from Xdebug engines through the port specified in the Debug port field.
Resolve breakpoint if it's not available on the current line (Xdebug 2.8+): if selected, the support for the Xdebug breakpoints resolving mechanism will be enabled in IntelliJ IDEA. Under this mechanism, the debugger evaluates whether PHP can generate internal executable bytecode for the current line. If no such code is generated for a line, the corresponding breakpoint cannot be hit. Xdebug will scan up to 5 subsequent lines, and stop at the line where executable code is located. Resolving breakpoints is supported in Xdebug 2.8 and later.
- Force break at first line when no path mapping specified: Select this checkbox to have the debugger stop as soon as it reaches and opens a file that is not mapped to any file in the project on the Servers page. The debugger stops at the first line of this file and Examine/update variables shows the following error message: Cannot find a local copy of the file on server <path to the file on the server> and a link Click to set up mappings. Click the link to open the Resolve Path Mappings Problem dialog and map the problem file to its local copy.
When this checkbox cleared, the debugger does not stop upon reaching and opening an unmapped file, the file is just processed, and no error messages are displayed.
Force break at first line when a script is outside the project: Select this checkbox to have the debugger stop at the first line as soon as it reaches and opens a file outside the current project. With this checkbox cleared, the debugger continues upon opening a file outside the current project.