使用PHP 8.4在宝塔面板中实现站点文件FTP同步需五步：一、配置并授权lftp同步脚本；二、启用exec函数并在PHP中调用脚本；三、设置计划任务定时执行；四、配置Pure-FTPd被动模式及防火墙；五、可选rsync over SSH替代FTP提升稳定性。
当您在宝塔面板中使用PHP 8.4运行站点，并需将代码变更实时同步至远程FTP服务器时，可能遇到权限限制、路径映射错误或被动模式连接失败等问题。以下是实现PHP 8.4站点文件同步操作的具体技巧：
一、配置FTP同步脚本并赋予PHP执行权限
通过编写Shell脚本调用lftp工具完成增量同步，确保PHP 8.4进程能安全调用该脚本，需调整脚本属主与SELinux/ACL策略。
1、登录服务器终端，进入/www/server/panel/scripts/目录，新建sync_ftp.sh文件。
2、写入以下内容：#!/bin/bash lftp -c "set ftp:passive-mode yes; open ftp://用户名:密码@FTP地址; mirror -R --delete --only-newer /www/wwwroot/站点域名 /远程目录"。
立即学习“PHP免费学习笔记（深入）”；
3、执行chmod +x /www/server/panel/scripts/sync_ftp.sh设置可执行权限。
4、运行chown www:www /www/server/panel/scripts/sync_ftp.sh，使宝塔PHP进程所属用户www可执行该脚本。
二、在PHP 8.4站点中调用系统级FTP同步
利用PHP的exec函数触发预设脚本，需在PHP配置中启用对应函数并关闭禁用函数列表中的限制项。
1、进入宝塔面板 → 网站 → 对应站点 → 设置 → PHP版本 → 管理PHP → 禁用函数，移除exec与shell_exec。
2、编辑站点根目录下的同步触发文件（如sync_trigger.php），写入： /dev/null 2>&1 &'); echo '同步已提交'; ?>。
3、访问http://站点域名/sync_trigger.php，验证是否成功启动后台同步任务。
三、使用宝塔计划任务定时触发FTP同步
避免手动调用，借助宝塔内置计划任务模块，在指定时间自动执行同步脚本，降低人为操作风险。
1、进入宝塔面板 → 计划任务 → 添加计划任务。
2、任务类型选择Shell脚本，执行周期设为每5分钟一次。
3、脚本内容填写：/www/server/panel/scripts/sync_ftp.sh > /www/wwwroot/站点域名/logs/ftp_sync.log 2>&1。
4、保存后点击“立即执行”，检查日志文件是否生成且无报错信息。
四、启用Pure-FTPd被动模式端口范围并放行防火墙
若同步过程中出现连接超时或数据通道建立失败，大概率是FTP服务端未正确配置被动模式端口段，导致PHP调用时无法建立数据连接。
1、进入宝塔面板 → 软件商店 → Pure-FTPd → 设置 → 被动模式端口范围，设置为30000-30100。
2、在服务器防火墙（如firewalld）中开放该端口段：firewall-cmd --permanent --add-port=30000-30100/tcp。
3、执行firewall-cmd --reload重新加载规则。
4、重启Pure-FTPd服务：bt restart pure-ftpd。
五、使用rsync over SSH替代FTP实现更稳定同步
当FTP协议频繁中断或受中间设备干扰时，可切换为基于SSH密钥认证的rsync方式，提升传输可靠性与安全性。
1、在目标服务器生成免密SSH密钥对：ssh-keygen -t rsa -b 4096 -f /root/.ssh/rsync_id_rsa -N ''。
2、将公钥追加至FTP服务器的authorized_keys：ssh-copy-id -i /root/.ssh/rsync_id_rsa.pub 用户名@FTP地址。
3、修改sync_ftp.sh脚本内容为：rsync -avz --delete -e "ssh -i /root/.ssh/rsync_id_rsa -o StrictHostKeyChecking=no" /www/wwwroot/站点域名/ 用户名@FTP地址:/远程目录/。
4、测试执行脚本，确认rsync输出中显示文件传输进度及无Permission denied提示。
