Ubuntu上phpstorm如何进行远程开发

Ubuntu 上 PhpStorm 远程开发实操指南

一 准备与网络连通

• 在远程 Ubuntu 主机安装并启动 SSH 服务，确保本机可登录：
  • 安装：sudo apt update && sudo apt install openssh-server
  • 可选加固：编辑 /etc/ssh/sshd_config，设置如 Port 22、PermitRootLogin prohibit-password、PasswordAuthentication yes，然后重启：sudo systemctl restart sshd
• 在远程主机安装 PHP（CLI）：sudo apt-get install php php-cli
• 创建用于开发的系统用户与项目目录，并设置权限（示例）：
  • 用户：sudo adduser remoteuser
  • 目录：mkdir -p /var/www/html/my_project && sudo chown -R remoteuser:remoteuser /var/www/html/my_project && sudo chmod -R 755 /var/www/html/my_project
• 本机与远程主机之间开放 SSH 端口（默认 22） 的防火墙/安全组访问。

二 在 PhpStorm 中配置远程解释器与部署

• 远程解释器（SSH Interpreter）
  • 打开：File → Settings → Languages & Frameworks → PHP → CLI Interpreter → 齿轮 → Add
  • 选择 SSH Interpreter，填写远程 Host/IP、Port 22、Username，认证方式可选 Password 或 SSH Key
  • 指定远程 PHP 可执行文件路径（常见如：/usr/bin/php），完成自动检测后保存
• 文件同步（Deployment）
  • 打开：File → Settings → Build, Execution, Deployment → Deployment → Configuration → + → SFTP
  • 配置连接参数（Host、Port、User、Auth），在 Mappings 中设置本地项目路径 ↔ 远程项目路径（如：/home/user/project ↔ /var/www/html/my_project）
  • 在工具栏的 Deployment 窗口执行 Test SFTP Connection，确认连通后使用自动/手动 Upload/Download 同步代码。

三 运行与调试配置

• 运行内置 Web 服务器（适合无外部 Web 服务的快速调试）
  • Run → Edit Configurations → + → PHP Built-in Web Server
  • 指定 Host: 0.0.0.0、Port: 8000、Document root: /var/www/html/my_project
  • 浏览器访问：http://服务器IP:8000（如需从外部访问，确保云主机安全组/防火墙放行 8000）
• 远程调试（Xdebug，断点、变量、堆栈可视化）
  • 远程安装 Xdebug：sudo apt install php-xdebug
  • 编辑对应版本的配置（示例路径：/etc/php/8.1/mods-available/xdebug.ini），启用并配置：
    • zend_extension=xdebug.so
    • xdebug.mode=debug
    • xdebug.start_with_request=yes
    • xdebug.client_host=你的本机IP
    • xdebug.client_port=9003
  • PhpStorm 设置：Settings → PHP → Debug，确认 Debug port: 9003
  • 配置 Server：Settings → PHP → Servers → +，填写远程站点域名/IP，选择 Debugger: Xdebug，启用 Use path mappings 并映射本地与远程目录
  • 启动调试：在需要的请求上触发（如浏览器访问带 XDEBUG_SESSION_START=PHPSTORM 的 URL，或使用书签/扩展），PhpStorm 将捕获断点并进入调试。

四 常见问题与排查

• SSH 连接失败：检查 /etc/ssh/sshd_config 配置、端口开放、密钥/密码是否正确，重启 sshd 后重试
• 路径映射不正确导致断点不生效：在 Servers 中务必正确设置本地与远程的 路径映射
• 调试无法连接：确认远程 xdebug.client_host 是本机可被访问的 IP，且 xdebug.client_port=9003 未被占用；云主机需放行 9003 端口
• 内置服务器仅限本机访问：将 Host 设为 0.0.0.0 并在安全组/防火墙放行对应 Port。

五 可选方案 Docker 远程解释器

• 在 PhpStorm 中：Settings → Build, Execution, Deployment → Docker → + → Add Remote，配置 Docker 守护进程连接（本地或远程）
• Settings → Languages & Frameworks → PHP → CLI Interpreter → + → Docker，选择镜像与挂载卷（将项目目录挂载到容器内）
• Run/Debug Configurations 选择相应的 Docker 解释器或 PHP Remote Debug，即可在容器中运行与调试。