PhpStorm 不能远程运行代码，而是同步项目后调用远程服务器的 PHP 解释器执行；关键在于正确配置远程 PHP 路径、权限、扩展及工作目录，确保 SSH 用户能非交互式执行 php -v 且环境变量生效。
PhpStorm 本身不能“远程运行代码”，它只是把本地项目同步到远端、再调用远端的 php 解释器执行——真正运行代码的是服务器，IDE 只负责触发、调试和展示结果。配置的关键不是“连上 SSH 就能跑”，而是让 PhpStorm 正确识别远端 PHP 环境路径、权限、扩展和工作目录。
为什么 PHP interpreter path 填 /usr/bin/php 还是报错？
常见现象：SSH 连接成功，但 PhpStorm 提示 Cannot resolve PHP executable 或 Failed to get PHP version。根本原因不是路径写错，而是：
- 远端用户（如
deploy）没有执行php的权限（比如被sudoers限制或 PATH 不包含/usr/bin） - 实际执行时用了非交互式 shell（
ssh user@host 'php -v'），而某些 shell 配置（如~/.bashrc中的 PATH 修改）在非交互模式下不加载 - 远端 PHP 是通过
update-alternatives或容器 alias 注册的，直接查/usr/bin/php返回的是 symlink，但 PhpStorm 没有跟随解析
实操建议：先手动 SSH 登录，运行 which php 和 php -v；再退回到本地，用相同用户执行 ssh user@host 'which php && php -v' —— 如果后者失败，就说明环境变量没生效，需在远端 ~/.bash_profile（而非 .bashrc）里补全 PATH。
如何让 PhpStorm 使用远端 composer 和扩展？
配置完解释器后，PhpStorm 默认仍用本地 composer 路径做依赖管理，导致 composer install 在本地执行失败，或远端扩展（如 redis、grpc）不被识别。
立即学习“PHP免费学习笔记（深入）”；
- 在
Settings > PHP > Composer中，把Composer executable改为Remote...，选择同一 SSH 配置，并填写远端composer全路径（如/home/deploy/.local/bin/composer） - 扩展检测依赖
php --ini输出，确保远端php.ini路径可读（尤其当使用php-fpm多配置时，CLI 和 FPM 的php.ini往往不同） - 如果远端 PHP 启用了
disable_functions（如禁用shell_exec），PhpStorm 的自动扩展扫描会卡住，此时需手动在PHP > Languages & Frameworks > PHP > Extensions中勾选已知启用的扩展
远程调试（Xdebug/Zend Debugger）为什么连不上？
解释器配好了，但断点不命中、Debug 控制台空白——这和解释器配置无关，是网络与调试代理问题。
- Xdebug 必须监听
0.0.0.0:9003（不是127.0.0.1），且远端防火墙放行该端口（ufw allow 9003） - PhpStorm 的
Settings > PHP > Servers中，“Host” 填的是你浏览器访问项目的域名（如dev.example.com），不是服务器 IP；“Debugger port” 必须和 Xdebug 配置一致（xdebug.client_port=9003） - 关键但易忽略：Xdebug 的
xdebug.client_host应设为你的本机公网 IP（或路由器内网 IP），而不是localhost—— 因为请求是从服务器发向你电脑，不是反向 - 若走 SSH 隧道调试，需在 PhpStorm 中启用
Use path mappings，并确保本地项目路径和远端部署路径完全一致（如都为/var/www/myapp）
最常被跳过的环节：远端 php -m | grep xdebug 显示已加载，但 php -i | grep xdebug 里看不到 client_host 或 mode=debug —— 说明 ini 文件没生效，或者被其他 conf 文件覆盖。别只改 /etc/php/*/cli/conf.d/99-xdebug.ini，检查 php --ini 输出的实际加载路径。
