Ubuntu下 PhpStorm 配置 FTP 步骤
一 准备工作
- 在远程服务器开启并放行对应服务端口：FTP 默认端口 21（数据端口由服务器/防火墙策略决定），SFTP 默认端口 22。如使用云服务器，确保安全组/防火墙已放行。
- 准备好远程项目的绝对路径（如：/var/www/html/myproject）与浏览器访问前缀（如：http://example.com/myproject）。
- 建议优先使用 SFTP（基于 SSH，更安全），若必须使用 FTP，请准备被动模式（PASV）可用的环境。
二 在 PhpStorm 中新建并测试连接
- 打开：File → Settings → Build, Execution, Deployment → Deployment → Configuration（macOS 为 Preferences）。
- 点击左上角 +，选择 FTP 或 SFTP，填写：
- Name：自定义名称
- FTP host / SFTP host：服务器 IP/域名
- Port：21（FTP）或 22（SFTP）
- Root path：远程项目根目录（如：/var/www/html/myproject）
- Authentication type：Password 或 Key pair（私钥路径）
- 填写 User name 与凭据
- 点击 Test Connection 测试连通性，成功后保存。
三 配置本地与远程路径映射
- 在配置页切到 Mappings：
- Local path：自动为当前项目根目录（如未自动，手动选择）
- Deployment path on server：与 Root path 一致或填写子目录（如：/ 或 /subdir）
- 勾选 Web path on server 并填写访问前缀（如：http://example.com/myproject）
- 如需将当前配置设为默认服务器，在 Deployment 页面勾选 Use this server as default。
四 同步与常用操作
- 自动上传（按需开启）：
- 进入 Settings/Preferences → Build, Execution, Deployment → Deployment，勾选 Upload changed files automatically to the default server。
- 触发条件建议选 On explicit save action（按 Ctrl+S 上传）或 On file change（文件变更即上传）。
- 在 Options 中，将 When files are changed outside PhpStorm 设为 Ask 或 Compare and ask，避免覆盖外部修改。
- 手动上传/下载/对比：
- 在项目工具窗口对文件或目录右键：Deployment → Upload to [服务器名] / Download from [服务器名]。
- 右键远程文件：Compare With Local Version 进行差异对比；对文件夹：Sync With Local 同步变更。
- 浏览远程文件：
- Tools → Deployment → Browse Remote Host，可直观查看、下载、上传远程目录。
五 常见问题与排查
- 连接超时或数据通道失败（FTP）：在 Advanced options 勾选 Passive mode（被动模式） 后重试。
- 连接被防火墙/云安全组拦截：确认已放行 21/22 端口（及 FTP 被动端口段，如服务器使用主动模式）。
- 权限不足或目录不存在：确保远程用户对 Root path 具备读写权限，路径填写为绝对路径且存在。
- 自动上传导致覆盖：将触发条件设为 On explicit save action，并在 Options 中对外部修改采取 Ask/Compare 策略。
- 修改未即时生效（PHP 环境）：若使用 OPcache，开发环境可先关闭或在变更后清理缓存，避免浏览器看不到最新结果。
