PHPStorm在Linux上的远程开发指南

PHPStorm 在 Linux 上的远程开发指南

一 环境准备

• 远程 Linux 主机
  • 安装并启动 SSH 服务：例如在 Ubuntu 上执行 sudo apt update && sudo apt install openssh-server，编辑 /etc/ssh/sshd_config 确保端口 22 开放，按需配置 PasswordAuthentication 或密钥登录，重启服务 sudo systemctl restart sshd。
  • 安装 PHP CLI：Ubuntu/Debian 执行 sudo apt-get install php php-cli；CentOS/RHEL 执行 sudo yum install php php-cli。
  • 创建项目目录并赋权：mkdir -p /var/www/html/my_project && sudo chown -R $USER:$USER /var/www/html/my_project && sudo chmod -R 755 /var/www/html/my_project。
• 本地 Linux 上的 PHPStorm
  • 从 JetBrains 下载并解压 Linux 版 PhpStorm，运行 ./phpstorm.sh 启动；确保已安装 JDK（满足运行要求）。

二 连接与解释器配置

• 配置远程解释器（SSH Interpreter）
  • 打开 File → Settings → Languages & Frameworks → PHP → CLI Interpreter → Add → SSH Interpreter，填写 Host/Port/Username，选择 Password 或 Key pair 认证；测试连接后选择远程 PHP 可执行文件路径（如 /usr/bin/php），保存为项目解释器。
• 配置 Deployment（SFTP 文件同步）
  • 打开 Tools → Deployment → Configuration → + → SFTP，填写 Host/Port/Root path，设置认证方式；在 Mappings 中配置本地项目路径与远程项目路径的映射（如 本地：/home/you/project → 远程：/var/www/html/my_project）；可开启 Auto-upload on Save 实现保存即同步。

三 运行与调试

• 远程运行与同步
  • 使用 Tools → Deployment 窗口进行 Upload/Download/Sync；在 Run/Debug Configurations 中新增 PHP Script 或 PHP Built-in Web Server，将 Interpreter 设为已配置的 SSH Interpreter，脚本路径或 Document root 指向映射后的远程目录，即可在远程环境运行与断点调试。
• 远程调试（Xdebug）
  • 在远程服务器安装并启用 Xdebug，在 php.ini 或 xdebug.ini 中启用远程调试，例如：zend_extension=/usr/local/php/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so、xdebug.remote_enable=1、xdebug.remote_host=<你的本机IP>、xdebug.remote_port=9001、xdebug.idekey="PHPSTORM"；重启 php-fpm 或 Web 服务。
  • 在 PhpStorm 中：File → Settings → PHP → Servers 新增服务器（Name/Host/Port 与项目一致），在 PHP → Debug 中设置 Debug port=9001；需要浏览器触发时可使用 Xdebug helper 扩展；启动 Listen for Debug Connections（工具栏甲虫图标），访问对应 URL 触发断点。

四 常见问题与排查

• SSH 连接失败
  • 检查远程 sshd 是否运行（sudo systemctl status sshd）、端口 22 是否放行、用户名/密钥是否正确；必要时在 /etc/ssh/sshd_config 中调整 PasswordAuthentication 或 PermitRootLogin 并重启服务。
• 解释器不可用或命令找不到
  • 在 SSH Interpreter 向导中选择正确的 PHP 路径（如 which php 输出）；若提示扩展缺失，先在远程安装对应 PHP 扩展 再重启服务。
• 文件不同步或路径映射错误
  • 在 Deployment → Mappings 核对本地与远程路径；确认 Root path 与项目实际目录一致；开启 Auto-upload 或手动 Sync 后再运行。
• 远程调试无法连接
  • 核对 xdebug.remote_port=9001 与 PhpStorm 的 Debug port 一致；确保 xdebug.remote_host 指向运行 PhpStorm 的机器 IP；如使用 NAT/云服务器，开放安全组/防火墙端口；浏览器端启用 Xdebug helper 并设置 IDE Key=PHPSTORM。