couldnt map file message

robf355

Hi
I'm trying out your php extension for VS 2022, I've got the project loaded, remote debugging on a centos server, when i start the debug this is what i get:

_> Starting Debugger Server ...
> Listening to Xdebug on 0.0.0.0:9003,[::]:9003
> Debugger Server is running.
Auto-attach to process '[632] PHP.Debugger.Systray.exe' on machine 'DESIGN' succeeded.
> Accepting connection from Xdebug.
> Sending the socket to Visual Studio (port 50477)_
_Couldn't map "file:///usr/share/php/auth_translation.php" to local project. Please check if the "auth_translation.php" exists and it's included in your project._
_There wasn't established any directory mapping. Debugging most likely won't work correctly.
The program '[0x29C4] php_remote.exe' has exited with code 4294967295 (0xffffffff).
Auto-attach to process '[10692] php_remote.exe' on machine 'DESIGN' succeeded._

usr/share/php/auth_translation.php exists,

I've tried google searches on the couldn't map file issue, but can't see how to fix it. Do I need to specify something in the file mapping section of the settings?
These nothing shown in the locals windows, so I assume as above that the debug session has failed
Regards
Rob

MiloslavBeno

Hi Rob,

Thank you for your post.

The most important thing to check first is whether you have the source files from your CentOS server (/usr/share/php/) also stored locally on your Windows machine and included in your Visual Studio project.

If those files don't exist locally, the debugger won't work correctly because Visual Studio has no source code to display or set breakpoints in. The extension usually handles mapping automatically if it can find the matching file within your local project structure.

How to resolve this:
Ensure Local Copies Exist: Make sure auth_translation.php (and any other files in /usr/share/php/ you need to debug) is part of your local VS project.

Manual Path Mapping: If the files are there but in a different folder structure than on the server, you need to tell Visual Studio how they relate:

Right-click your Project in Solution Explorer -> Properties.

Go to the Debug tab and find Path Mappings.
Add an entry:
- Remote Path: /usr/share/php/
- Local Path: (The equivalent folder on your Windows machine).

robf355

Hi
Thanks, copying the auth_translation.php file removed that issue. when I start the debugger now I get this message:

> Starting Debugger Server ...
> Listening to Xdebug on 0.0.0.0:9003,[::]:9003
> Debugger Server is running.
Auto-attach to process '[5752] PHP.Debugger.Systray.exe' on machine 'DESIGN' succeeded.
> Accepting connection from Xdebug.
> Sending the socket to Visual Studio (port 52520)
Mapping dir 'C:\Users\rob100763\source\repos' to 'file:///usr/share/php'
The program '[0x1F68] php_remote.exe' has exited with code 4294967295 (0xffffffff).
Auto-attach to process '[8040] php_remote.exe' on machine 'DESIGN' succeeded.

I I insert a breakpoint nothing is hit, the application is a webpage posting data, the application returns an http timeout error because it doesn't get a response form the ph, but even with a breakpoint at the start of the php file it still isn't hit, the xdebug log is here:

[5221] Log opened at 2026-02-17 15:10:27.861609
[5221] [Step Debug] INFO: Checking remote connect back address.
[5221] [Step Debug] INFO: Checking header 'HTTP_X_FORWARDED_FOR'.
[5221] [Step Debug] INFO: Checking header 'REMOTE_ADDR'.
[5221] [Step Debug] INFO: Client host discovered through HTTP header, connecting to 192.168.0.195:9003.
[5221] [Step Debug] INFO: Connected to debugging client: 192.168.0.195:9003 (from REMOTE_ADDR HTTP header). :-)
[5221] [Step Debug] -> <init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" fileuri="file:///usr/share/php/auth_translation.php" language="PHP" xdebug:language_version="7.4.33" protocol_version="1.0" appid="5221" idekey="users"><engine version="3.1.6"><![CDATA[Xdebug]]></engine><author><![CDATA[Derick Rethans]]></author><url><![CDATA[https://xdebug.org]]></url><copyright><![CDATA[Copyright (c) 2002-2022 by Derick Rethans]]></copyright></init>

[5221] [Step Debug] <- breakpoint_set -i x0-10002 -t exception -x "Unknown error"
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="x0-10002" id="52210013"></response>

[5221] [Step Debug] <- breakpoint_set -i x1-10000 -t exception -x "Fatal error"
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="x1-10000" id="52210014"></response>

[5221] [Step Debug] <- breakpoint_set -i x2-10001 -t exception -x "Parse error"
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="x2-10001" id="52210015"></response>

[5221] [Step Debug] <- feature_set -i 3 -n resolved_breakpoints -v 1
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="feature_set" transaction_id="3" feature="resolved_breakpoints" success="1"></response>

[5221] [Step Debug] <- feature_set -i 4 -n notify_ok -v 1
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="feature_set" transaction_id="4" feature="notify_ok" success="1"></response>

[5221] [Step Debug] <- feature_get -i 5 -n max_children
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="feature_get" transaction_id="5" feature_name="max_children" supported="1"><![CDATA[32]]></response>
[5221] [Step Debug] <- breakpoint_set -i 6-0 -s enabled -t line -f file:///usr/share/php/GetCustData.php -n 23
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="6-0" state="enabled" id="52210016" resolved="unresolved"></response>

[5221] [Step Debug] <- step_into -i 7
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="step_into" transaction_id="7" status="break" reason="ok"><xdebug:message filename="file:///usr/share/php/auth_translation.php" lineno="2"></xdebug:message></response>

[5221] [Step Debug] <- stack_get -i 8-0
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="stack_get" transaction_id="8-0"><stack where="{main}" level="0" type="file" filename="file:///usr/share/php/auth_translation.php" lineno="2"></stack></response>

[5221] [Step Debug] <- breakpoint_list -i 9
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_list" transaction_id="9"><breakpoint type="exception" resolved="resolved" exception="Unknown error" state="enabled" hit_count="0" hit_value="0" id="52210013"></breakpoint><breakpoint type="exception" resolved="resolved" exception="Fatal error" state="enabled" hit_count="0" hit_value="0" id="52210014"></breakpoint><breakpoint type="exception" resolved="resolved" exception="Parse error" state="enabled" hit_count="0" hit_value="0" id="52210015"></breakpoint><breakpoint type="line" resolved="unresolved" filename="file:///usr/share/php/GetCustData.php" lineno="23" state="enabled" hit_count="0" hit_value="0" id="52210016"></breakpoint></response>

[5221] [Step Debug] <- run -i 10
[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="run" transaction_id="10" status="stopping" reason="ok"></response>

[5221] Log closed at 2026-02-17 15:10:27.984545

The debugger still doesn't break, I noticed this entry in xdebug.log:

[5221] [Step Debug] -> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="https://xdebug.org/dbgp/xdebug" command="breakpoint_list" transaction_id="9"><breakpoint type="exception" resolved="resolved" exception="Unknown error" state="enabled" hit_count="0" hit_value="0" id="52210013"></breakpoint><breakpoint type="exception" resolved="resolved" exception="Fatal error" state="enabled" hit_count="0" hit_value="0" id="52210014"></breakpoint><breakpoint type="exception" resolved="resolved" exception="Parse error" state="enabled" hit_count="0" hit_value="0" id="52210015"></breakpoint><breakpoint type="line" resolved="unresolved" filename="file:///usr/share/php/GetCustData.php" lineno="23" state="enabled" hit_count="0" hit_value="0" id="52210016"></breakpoint></response>

Why is the log referring to file:///usr/share/php/GetCustData.php" when the actual document root is /home/e-smith/files/ibays/kjcdatabase/html/GetCustData.php Is this a setup error, there nothing listed in /usr/share/php
Thanks for any help you can offer

robf355

Update, I can single step the code under the debugger, but I can only set a breakpoint in one php module: auth_translation.php.
All other breakpoints are missed. I can also single step through the entire code sequence without an issues.
output:
`> Starting Debugger Server ...

Listening to Xdebug on 0.0.0.0:9003,[::]:9003
Debugger Server is running.
Auto-attach to process '[9696] PHP.Debugger.Systray.exe' on machine 'DESIGN' succeeded.
Accepting connection from Xdebug.
Sending the socket to Visual Studio (port 50672)
Mapping dir 'C:\Users\rob100763\source\repos' to 'file:///usr/share/php'
Auto-attach to process '[11108] php_remote.exe' on machine 'DESIGN' succeeded.
Accepting connection from Xdebug.
Sending the socket to Visual Studio (port 50672)
Auto-attach to process '[7224] php_remote.exe' on machine 'DESIGN' succeeded.
Accepting connection from Xdebug.
Sending the socket to Visual Studio (port 50672)
Auto-attach to process '[1956] php_remote.exe' on machine 'DESIGN' succeeded.`

Is the ref to file:///usr/share/php a folder on the server or a virtual folder on the client PC, on the server this folder only has auth_translation.php in it, none of the other source files are there. Could this be the cause of the breakpoint issue?

robf355

I fixed the issue it was the path mapping that needed to be changed

MiloslavBeno

Hi Rob,

Great, thank you for letting us know! Yes, path mapping is crucial.

Xdebug tells Visual Studio the server-side path (like /usr/share/php), and without a mapping to your local folder, Visual Studio doesn't know where to "place" the breakpoints in your local project.

I'm glad you got it sorted! Let us know if you run into any more hurdles.