xDebug должен быть установлен в систему любым известным способом. Результат установки должен быть виден через phpinfo();
Правим php.ini.
[xdebug]
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.log="C:\Windows\Temp\xdebug.log"
xdebug.client_port=9001,9003
xdebug.idekey = "PHPSTORM"
;xdebug.discover_client_host = 1
xdebug.start_with_request = yes
xdebug.start_upon_error = no
Поддержка PHPStorm xDebug 3 началась с 2020, на предыдущих версиях надо ставить xDebug 2
xdebug.start_with_request = yes важный параметр у меня без него не стартовали точки останова
xdebug.start_upon_error = no тоже достаточно интересный, если выставить в yes то останавливаться будет там где проиходят exeption в конструкции try ... catch
xdebug.discover_client_host = 1 для удаленной отладки хорош, сканет доступные debug bridge и цепляется к ним, может у кого то отдельная машина поднята под дебаг.
Настройки PHPStorm
По моим наблюдениям этой магии вполне достаточно.
Update:
In the default configuration, the debugger activates if a "trigger" is present, although it's possible to instruct the debugger to always initiate a debugging session by setting xdebug.start_with_request to yes.
Это значит, что когда используем удаленную отладу - лучше включать этот параметр по умолчанию да