如何在PhpStorm中通过网络共享用Xdebug调试远程服务器（免下载/SSH）

可以实现，核心是通过路径映射让PhpStorm关联本地共享文件夹与远程服务器的文件路径，配合Xdebug的跨机器调试配置即可，具体步骤如下：

1. 配置PhpStorm的服务器路径映射 #

• 打开PhpStorm，进入 File > Settings > Languages & Frameworks > PHP > Servers（Windows/Linux）或 PhpStorm > Settings...（Mac）
• 点击「+」添加新服务器：
  • Name：自定义名称（如「Remote Shared Server」）
  • Host：填写远程服务器的域名或公网/局域网IP（即网站对外访问的地址）
  • Port：对应网站运行端口（通常是80或443）
  • Debugger：选择「Xdebug」
• 勾选 Use path mappings，在列表中添加映射规则：
  • 本地路径：选择你挂载的网络共享文件夹的根目录（如 Z:\project-root）
  • 服务器路径：填写该共享文件夹在远程服务器上的绝对路径（如 /var/www/project-root）
• 保存配置

2. 配置远程服务器的Xdebug参数 #

找到服务器上的PHP配置文件（如 php.ini 或单独的 xdebug.ini），添加/修改以下Xdebug配置：

xdebug.mode = debug
xdebug.client_host = 你的本地机器IP（服务器可访问的IP，如局域网IP或公网IP）
xdebug.client_port = 9003（默认端口，需与PhpStorm配置一致）
xdebug.start_with_request = yes
xdebug.discover_client_host = 0

修改完成后，重启服务器的PHP服务（如 systemctl restart php-fpm 或 service apache2 restart，根据服务器环境而定）

3. 启动PhpStorm的调试监听 #

• 点击PhpStorm右上角的「电话」图标，确保图标亮起（表示已开启PHP调试连接监听）
• 进入 File > Settings > Languages & Frameworks > PHP > Debug，确认 Debug port 为9003，勾选 Can accept external connections

4. 开始调试 #

• 在本地共享文件夹的PHP文件中设置断点（点击行号旁空白处，出现红色圆点）
• 访问远程服务器上的目标页面（如 http://服务器IP/test.php），PhpStorm会自动捕获Xdebug的调试请求，弹出调试窗口，即可进行单步调试、查看变量、调用栈等操作

关键注意事项 #

• 确保远程服务器能访问到你的本地机器的9003端口（若有防火墙，需开放该端口的入站规则）
• 网络共享文件夹需具备可读权限，PhpStorm能正常读取文件（若需修改代码，修改后会直接同步到服务器）
• 若断点未命中，优先检查路径映射是否完全匹配（本地与服务器的路径层级必须一一对应）

内容的提问来源于stack exchange，提问作者Leonel Matias Domingos