在 phpstorm 中实现远程部署需五步：一、通过 file → deployment → configuration 配置 ftp/sftp 连接；二、设置本地与远程路径映射；三、启用自动上传（on explicit save 或 on file change）；四、支持手动上传/下载；五、可用内置终端执行 rsync 增量同步。
如果您希望在 PhpStorm 中将本地项目文件上传至远程服务器进行开发与测试，则需要配置 FTP 部署并启用自动或手动同步功能。以下是实现远程部署的具体操作步骤：
一、配置 FTP 服务器连接
该步骤用于在 PhpStorm 中建立与远程服务器的通信通道，确保 IDE 能识别目标主机、认证凭据及路径映射关系。
1、点击顶部菜单栏 File → Deployment → Configuration。
2、在弹出窗口中点击左上角 + 号，选择 FTP。
立即学习“PHP免费学习笔记（深入）”；
3、在右侧填写服务器名称（任意命名），并在 SFTP host 或 FTP host 栏输入远程服务器 IP 地址或域名。
4、设置端口（FTP 默认为 21，SFTP 默认为 22），选择协议类型为 FTP 或 SFTP（推荐 SFTP）。
5、在 Root path 中填写远程服务器上项目根目录的绝对路径，例如 /var/www/html/myproject。
6、在 Authentication type 中选择 Password 或 Key pair，并填入用户名与密码（或指定私钥文件路径）。
二、设置本地与远程路径映射
此步骤定义本地项目文件夹与远程服务器对应目录之间的关联关系，是后续上传、下载和同步操作的基础。
1、在 Deployment 配置窗口左侧选中刚创建的服务器条目。
2、点击右侧 Mappings 选项卡。
3、在 Local path 栏自动填充当前项目根路径；若未自动填充，可点击右侧文件夹图标手动选择。
4、确认 Deployment path on server 与之前配置的 Root path 一致，或根据需要调整子路径（如 / 表示映射到根目录下）。
5、勾选 Web path on server 并填写可通过浏览器访问的 URL 前缀，例如 http://example.com/myproject。
三、启用自动上传与同步策略
该设置决定文件保存后是否立即上传至服务器，以及冲突时如何处理，直接影响开发效率与数据一致性。
1、进入 File → Settings → Build, Execution, Deployment → Deployment（Windows/Linux）或 PhpStorm → Preferences → Build, Execution, Deployment → Deployment（macOS）。
2、勾选 Upload changed files automatically to the default server。
3、在下拉菜单中选择触发条件：On explicit save action（仅按 Ctrl+S 时上传）或 On file change（实时监听修改并上传）。
4、点击 Options 按钮，在弹出窗口中设置 When files are changed outside PhpStorm 为 Ask 或 Compare and ask，避免覆盖外部修改。
四、手动上传与下载文件
当自动同步不可用或需精确控制传输范围时，可通过右键菜单执行单次或批量文件操作。
1、在项目工具窗口（Project Explorer）中，右键点击某个文件或文件夹。
2、选择 Deployment → Upload to [服务器名称]。
3、若需从服务器拉取最新版本，右键选择 Deployment → Download from [服务器名称]。
4、上传过程中可在底部状态栏查看进度条；失败时会显示错误提示，常见原因包括权限不足、路径不存在或网络中断。
五、使用内置终端执行 rsync 同步（替代方案）
对于高频更新或大体积项目，rsync 提供更高效、增量式的同步能力，且支持排除规则与压缩传输。
1、打开 PhpStorm 内置终端（Alt+F12 或 View → Tool Windows → Terminal）。
2、执行以下命令完成单次同步：rsync -avz --delete -e "ssh -p 22" ./user@host:/var/www/html/myproject/。
3、将上述命令保存为外部工具：进入 Settings → Tools → External Tools，点击 + 号 添加新工具，设置 Program 为 rsync，Arguments 为完整参数字符串，Working directory 设为 $ProjectFileDir$。
4、配置完成后，可通过右键菜单或快捷键直接调用该 rsync 命令完成同步。
