PhpStorm 与 CentOS 的 SSH 连接与远程开发指南
一 前置检查
- 确认 CentOS 已安装并运行 SSH 服务，默认端口为 22；如使用云服务器，需在安全组放行 TCP 22。
- 准备登录凭据：用户名与密码，或 SSH 密钥对（推荐）。如使用密钥，注意私钥文件权限应为仅用户可读（如 600）。
- 规划项目路径：确定服务器上的项目目录（如 /var/www/html），便于后续映射与同步。
二 配置 Deployment 的 SFTP 连接
- 打开 PhpStorm → File → Settings → Build, Execution, Deployment → Deployment，点击 + → Configuration，类型选择 SFTP。
- 填写连接信息：
- Name：自定义名称
- Type：SFTP
- Host：服务器 IP/域名
- Port：22
- User name：登录用户名
- Auth type：Password 或 Key pair（私钥路径）
- 点击 Test Connection 验证连通性。
- 切换到 Mappings：
- Local path：本地项目根目录
- Deployment path：服务器上的对应目录（相对路径或绝对路径）
- 应用保存后，可使用 Tools → Deployment 进行手动/自动上传与下载。
三 配置远程 PHP 解释器
- 打开 PhpStorm → File → Settings → Languages & Frameworks → PHP → CLI Interpreter，点击齿轮选择 Add → SSH Interpreter。
- 新建 SSH 连接（可复用上一步的 Host/Port/Auth），在 Interpreter 处指定服务器上的 PHP 可执行文件路径（如 /usr/bin/php 或 /usr/sbin/php-fpm）。
- 确认后应用设置，使代码提示、运行与测试基于远程环境执行。
四 常见问题与排查
- 连接超时或被拒绝：检查 IP/端口、服务器 SSH 服务状态、以及云厂商 安全组/防火墙 规则是否放行 22 端口。
- 密钥认证失败：确认私钥与服务器侧公钥匹配，且私钥文件权限为 600；必要时使用 ssh-add 将私钥加入 SSH 代理。
- 权限不足：确保登录用户对目标目录具备 读写/执行 权限。
- 路径映射错误：核对 Mappings 中本地与远程路径的一一对应关系，避免上传到错误目录。
- 配置变更未生效：修改 php.ini 或解释器后，重启 PHP-FPM/Web 服务（如 systemctl restart php-fpm）。
