Try to configure your project in PhpStorm

  1. Open Settings->Languages & Frameworks->PHP->Debug
  2. Uncheck the "Ignore external connections through unregistered server configurations" option
  3. OK
Answer from Jekis on Stack Overflow
🌐
JetBrains
jetbrains.com › help › phpstorm › troubleshooting-php-debugging.html
Troubleshooting common PHP debugging issues | PhpStorm Documentation
June 12, 2025 - In the Settings dialog (Ctrl+Alt+S) , navigate to PHP | Debug and make sure PhpStorm and Xdebug / Zend Debugger are configured with the same port numbers. In PhpStorm, enable listening to incoming debug connections by doing any of the following:
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 205972064-PHPSTORM-not-receiving-debug-connection-from-xdebug-2-5
PHPSTORM not receiving debug connection from xdebug 2.5 – IDEs Support (IntelliJ Platform) | JetBrains
November 16, 2016 - Not sure about everyone's issue with this, but I think the OP's was due to this line: xdebug.remote_host=localhost For debugging on remote servers the host IP address needs to be set to the IP address of the machine running PhpStorm, not the ...
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 18563394907538-PhpStorm-unable-to-recieve-Xdebug-connections
PhpStorm: unable to recieve Xdebug connections – IDEs Support (IntelliJ Platform) | JetBrains
April 25, 2024 - [14006] [Step Debug] WARN: Creating socket for '192.168.10.104:9003', poll success, but error: Operation now in progress (29). [14006] [Step Debug] ERR: Could not connect to debugging client. Tried: 192.168.10.104:9003 (through xdebug.client_host/xdebug.client_port) :-( [14006] Log closed at 2024-04-26 01:51:38.566510
🌐
JetBrains
jetbrains.com › help › phpstorm › configuring-xdebug.html
Configure Xdebug | PhpStorm Documentation
To have PhpStorm accept any incoming connections from Xdebug engine through the port specified in the Debug port field, select the Can accept external connections checkbox.
🌐
Super User
superuser.com › questions › 1418099 › phpstorm-not-receiving-debug-connection-when-accessing-the-web-server-from-a-rem
php - PHPStorm not receiving debug connection when accessing the web server from a remote host - Super User
March 27, 2019 - Replacing xdebug.remote_connect_back with xdebug.remote_host seems to solve the issue. xdebug.remote_enable = 1 xdebug.remote_autostart = 1 xdebug.remote_host = IP_OF_HOST_RUNNING_PHPSTORM xdebug.remote_port = 9009
Find elsewhere
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 20030630763922-Debugging-in-PHPStorm-using-Xdebug-does-not-work
Debugging in PHPStorm using Xdebug does not work – IDEs Support (IntelliJ Platform) | JetBrains
July 8, 2024 - ... Could you please disable Settings | PHP | Debug | Ignore external connections through unregistered server configurations option and check once again? ... Yes it now prompt the Incoming Connection from Xdebug.
🌐
Laracasts
laracasts.com › discuss › channels › testing › problems-with-xdebug-phpstorm
Problems with Xdebug & PHPStorm
I used port 9000. The url when I start debugging is: http://app.shizzle/?XDEBUG_SESSION_START=12089 · You don't need to set the port in apache for listening. Your phpstorm will be listening on a port.
🌐
Local
community.localwp.com › support
How do I make Xdebug work in PhpStorm? - Support - Local Community
May 17, 2024 - I tried all the steps from Xdebug nightmare - #8 by Glauber. But I do not see any dialogue box in PhpStorm as mentioned below. I am not using the LocalWP addon, I disabled it.
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 360000606090-PhpStorm-not-reacting-to-xdebug
PhpStorm not reacting to xdebug – IDEs Support (IntelliJ Platform) | JetBrains
So the server breaks on the line as instructed, sends data to PHPStorm. The firewall blocks the data transmission, so PHPStorm never receives the signal to activate the debug tools.
Top answer
1 of 1
8

Xdebug 3 will be fully supported in PhpStorm 2020.3 version only, which is currently in EAP stage (Early Access Program) and will be released in about 1 month time.

It is already supported in the most recent EAP #6 build: check this blog post for more info: https://blog.jetbrains.com/phpstorm/2020/11/phpstorm-2020-3-eap-6/


I have downloaded Xdebug 3.0.0beta1 for my PHP 7.4 on Windows 10, configured it from scratch (using correct Xdebug 3 config values: https://3.xdebug.org/docs/upgrade_guide and https://3.xdebug.org/docs/all_settings) ... and it still works fine in PhpStorm 2020.2.3.

Yes, IDE sends old-style parameters when initiating debugging for a CLI script (like xdebug.remote_{host, port} etc) but the debug still works just fine.

This is my php.ini content for Xdebug 3 settings (as simple as this):

[xdebug]
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9001
xdebug.mode = debug

(I have a bit mores settings, but those are customisation for output file names, log locations, extra stuff for quickly turn on some options in some scenarios/when needed etc -- these are not needed here and it works fine without them)

CLI debug initiated from IDE ("PHP Script" type of configuration):

That's what IDE is executing: E:\Projects\php\php74\php.exe -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9001 -dxdebug.remote_host=127.0.0.1 E:\Projects\web\_idetest\test.php. As you may see these old style parameters do not affect Xdebug 3 at all.

P.S. If I set xdebug.start_with_request = yes in php.ini then debug will work even for Run (or when executing that PHP script outside of IDE) -- as long as "phone handle" icon is green (IDE listens for incoming debug requests).

🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 19233470681106-xdebug-can-t-connect-from-web-page-in-PHPStorm-2024-1-2
xdebug can't connect from web page in PHPStorm 2024.1.2 – IDEs Support (IntelliJ Platform) | JetBrains
1. `xdebug.log` shows [3808] Log opened at 2024-05-31 00:55:11.498414 [3808] [Step Debug] WARN: Debugger is not working optimally, as Xdebug is loaded before Zend OPcache [3808] Log closed at 2024-05-31 00:55:11.758367 2. Checked. Unchecking it brought up the dialog to accept the connection once, but that was it. Restarting PHPStorm didn't bring it up like it usually does after restart, and still no breakpoints working.
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 360009532740-Unable-to-get-PHPStorm-to-connect-to-xdebug-running-in-WSL-2
Unable to get PHPStorm to connect to xdebug running in WSL 2 – IDEs Support (IntelliJ Platform) | JetBrains
Adding options like `xdebug.remote_enable=1` to the config, but this is being done by PHPStorm anyways when it runs the remote php instance (`remote_connect_back` also did not do the trick): [wsl://UBUNTU2004]:php -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9006 -dxdebug.remote_host=172.18.48.1 /home/spaceemotion/code/xxxxxx/backend/vendor/phpunit/phpunit/phpunit [rest ommitted]
🌐
JetBrains
intellij-support.jetbrains.com › hc › en-us › community › posts › 360004225939-Xdebug-not-connecting
Xdebug not connecting – IDEs Support (IntelliJ Platform) | JetBrains
June 24, 2019 - * install chrome debug extension (Xdebug Helper). Mark project site as "debug" in the extension's drop down menu. * Click the phone icon in the top right of Phpstorm to enable listening for Xdebug on port 9000
🌐
Lloydleung
lloydleung.com › 2022 › 12 › 27 › phpstorm-unable-to-establish-connection-with-xdebug
phpstorm unable to establish connection with xdebug – Lloyd Leung
December 27, 2022 - Cannot start debugger session with ‘Xdebug 3.2.0’ · The way to fix that, was just to ensure that we’re using the proper port. Xdebug 3.x, uses port 9003. Where as Xdebug 2.x used 9000. To fix this, change your phpStorm preferences for the listening port to 9003.
🌐
VVV
varyingvagrantvagrants.org › docs › en-US › references › xdebug-and-phpstorm
Debugging with xdebug and PhpStorm | VVV
For PhpStorm and xdebug to correctly hit breakpoints and talk to each other, we need to tell PhpStorm how the files it knows about are mapped to the files that VVV knows about. There is a way to get the server going manually but there is an easier way: get PhpStorm to do the important bits for us. Here’s how. ... PhpStorm will detect a request to connect, but will complain that path mappings are not set up.