phpstorm如何配置多个SFTP服务器进行切换（多环境分发）-phpstorm-PHP中文网

phpstorm支持为一个项目配置多个sftp连接，需在tools → deployment → configuration中逐一添加，每条连接对应独立环境（如staging、prod-us），并须先在settings → tools → ssh configurations中配置对应ssh连接；各连接需设置正确的root path和mappings映射，且仅当前设为default的服务器响应自动上传，切换目标需右键选择“set as default”。

phpstorm如何配置多个sftp服务器进行切换（多环境分发）

一个项目怎么配多个 SFTP 连接

PhpStorm 本身不支持“单次保存自动发到多个服务器”，但可以为同一个项目配置多个 SFTP 部署目标，手动或按需触发上传。关键不是“同时发”，而是“随时切、随时传”。配置入口在 Tools → Deployment → Configuration，这里添加的每一条记录就是一个独立的 SFTP 连接，名字要能区分环境（比如 staging、prod-us、prod-cn）。

注意：这些连接必须先有对应的 SSH 配置。进 Settings → Tools → SSH Configurations，点 + 添加，填好 host、user、auth 方式（密码 or key）、端口。测试连通性成功后再回到 Deployment 配置里引用它——否则 Connection failed 错误会卡在下一步。

每个 SFTP 配置里的 Root path 必须写对，比如 /var/www/html 或 /home/deploy/app，不能留空或填错斜杠方向
如果服务器用非标准端口（比如 2222），一定要在 SSH 配置里显式填上，Deployment 配置里不会继承端口字段
别把多个环境共用一个 SSH 配置名——重命名它，比如 prod-server-2222，否则后续选错连接很难排查

保存时自动上传只生效于当前激活的部署目标

所谓“自动上传”，其实是绑定在当前选中的 deployment target 上的。进 Settings → Tools → Deployment → Options，勾选 Upload changed files automatically to the default server，这个“default server”就是你在 Deployment → Configuration 列表里右键设为 Default 的那一个。

也就是说：你改了代码，只有当前默认的那个 SFTP 目标会自动传；其他目标完全不动。想换目标？右键另一条配置 → Set as Default 即可切换，无需重启 IDE。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

快捷键 Ctrl + Alt + Shift + D（Linux/Windows）可快速打开部署菜单，直接选 Upload to … 手动传到任意已配目标
上传失败常见原因是路径权限不足，错误信息通常是 Permission denied (publickey) 或 Failed to create directory，优先检查 SSH 配置里的用户是否有对应目录写入权限
如果某台服务器禁用了 ~/.ssh/authorized_keys 自动加载（比如某些 hardened 环境），得手动指定私钥路径，在 SSH 配置的 Authentication type → Key pair 里点文件夹图标选 .pem 或 id_rsa

多环境映射路径别写死，用相对路径+映射规则

不同服务器上的项目路径往往不一致（比如 staging 是 /var/www/myapp，prod 是 /opt/app/current），硬编码会导致上传错位置。正确做法是在每条 SFTP 配置的 Mappings 标签页里设置本地路径与远程路径的映射关系。

例如本地项目根是 /home/user/project，那么：

对 staging：本地 . → 远程 /var/www/myapp
对 prod-us：本地 . → 远程 /opt/app-us/current
对 prod-cn：本地 . → 远程 /opt/app-cn/current

这样上传时 PhpStorm 才知道该把 index.php 放到哪一层目录下。如果留空 Mappings，它会按 Root path 全量覆盖，极容易误删线上文件。

Mapping 的本地路径建议用 .（项目根），避免写绝对路径，否则换机器或用户就失效
远程路径末尾不加斜杠，否则可能生成双斜杠导致 404 或上传失败
如果项目含子模块或 vendor，又不想传整个目录，可在 Excluded Paths 里加 vendor/、.git/ 等，减少传输量

上传后怎么验证是否真到了目标服务器

别光看 PhpStorm 底部状态栏显示 “Uploaded successfully”。真实场景中，经常出现“上传成功”但文件没更新——因为目标路径映射错了、用户权限不够、或者服务器开了 opcache 没刷新。

最稳的验证方式是开终端，SSH 进去直接 ls -l 看时间戳，或 md5sum 对比关键文件哈希。如果频繁需要验证，建议在 Tools → Terminal 里预设几个常用命令 alias，比如：alias prod-ls='ssh deploy@prod.example.com ls -lt /opt/app/current/index.php'。