Ubuntu 上 PhpStorm 远程开发实操指南
一 准备与连接
- 在远程 Ubuntu 主机安装并启动 SSH 服务，确保本地与服务器之间网络可达（默认端口 22）。
- 建议创建专用开发用户，并配置基于 SSH 密钥 的免密登录（更安全、免频繁输入密码）。
- 在 PhpStorm 中建立到服务器的 SFTP 连接，用于文件同步与远程执行。
- 在 PhpStorm 中配置 远程解释器（SSH Interpreter），让代码在远端执行、在本机调试与运行。
以上步骤完成后，即可在本地编辑、远端运行与调试，实现高效的远程开发工作流。
二 详细配置步骤
- 远程服务器准备
- 安装 SSH 服务：sudo apt update && sudo apt install openssh-server；如需自启动：sudo systemctl enable --now sshd。
- 创建用户（示例）：sudo adduser remoteuser；如需免密登录，在本地生成密钥对后将公钥（如 ~/.ssh/id_rsa.pub）追加到远端 ~/.ssh/authorized_keys，并设置私钥权限为 600：chmod 600 ~/.ssh/id_rsa。
- PhpStorm 配置 Deployment（SFTP）
- 打开：File → Settings → Deployment → Configuration → 新建 SFTP；填写主机、端口 22、用户名，选择认证方式（密码或私钥）。
- 在 Mappings 中设置本地项目路径与远端项目路径的映射（例如：/home/local/project ↔ /var/www/project），完成后执行 Test SFTP Connection 验证。
- PhpStorm 配置远程解释器（SSH Interpreter）
- 打开：File → Settings → Languages & Frameworks → PHP → CLI Interpreter → Add → SSH Interpreter；选择现有 SFTP 配置或新建 SSH 连接。
- 指定远端 PHP 可执行文件路径（常见为 /usr/bin/php），PhpStorm 会自动检测版本与扩展；应用设置后，运行与调试将使用远端解释器。
- 运行与调试
- 新建运行配置（Run/Debug Configurations）：选择 PHP Remote Debug，配置远端服务器 Host/IP 与 Port（默认 9003），并在服务器开启 Xdebug 后使用浏览器触发断点调试。
以上流程覆盖从连接、同步到解释器与调试的关键配置，适用于在 Ubuntu 主机上进行远程 PHP 开发。
三 运行与调试
- 远程解释器执行
- 配置完成后，PhpStorm 的 CLI 命令、单元测试、Composer 等都会在远端执行；本地仅负责编辑、版本控制与界面交互。
- Xdebug 远程调试
- 在远端 php.ini 启用并配置 Xdebug（示例）：
- zend_extension=xdebug.so
- xdebug.mode=debug
- xdebug.start_with_request=trigger
- xdebug.client_host=你的本机IP（如从远端访问本机）
- xdebug.client_port=9003
- 在 PhpStorm 创建 PHP Remote Debug 运行配置，指定服务器与端口；访问页面时在 URL 后附加 ?XDEBUG_TRIGGER=1 触发调试，即可命中断点并查看变量、调用栈。
- 远程终端
- 通过 Tools → Start SSH Session 打开远端终端标签，直接在远端执行命令、查看日志与维护环境。
上述方式可实现本地编码、远端运行与断点调试的一体化体验。
四 常见问题与排查
- 连接失败
- 检查远端 sshd 状态：sudo systemctl status sshd；确认云主机安全组/防火墙放行 22 端口；必要时查看 /var/log/auth.log 获取 SSH 登录日志。
- Permission denied（公钥认证失败）
- 确认远端 ~/.ssh/authorized_keys 已包含你的公钥；检查远端 ~/.ssh 目录与 authorized_keys 权限（建议 700/600）；本地私钥权限为 600。
- 文件无法上传/下载或菜单缺失
- 在 Deployment → Mappings 正确设置本地与远端的根路径映射；路径错误会导致同步与上传菜单不可用。
- 解释器不可用或扩展缺失
- 在 PHP CLI Interpreter 页面点击刷新，确认 PHP 路径与 php.ini 位置；必要时在远端安装所需扩展（如通过 apt/yum）。
以上为高频问题与快速修复路径，可显著提升排障效率。