PHP不提供开箱即用的文件同步服务，但可编写轻量单向同步逻辑；用file_get_contents+file_put_contents拉取远程文件时需注意小文件适用性及错误处理。
PHP 本身不提供开箱即用的「文件同步」服务（比如 rsync 那种双向实时同步），但可以用它写一个轻量、可控、单向的文件同步逻辑——适用于定时拉取远程资源、部署静态资产、备份日志等场景。关键在于：别把它当同步工具用，而要当「同步逻辑调度器」来用。
用 file_get_contents + file_put_contents 拉取远程文件时要注意什么
这是最简单的 HTTP 文件拉取方式，适合小文件（
- 远程 URL 必须以
http://或https://开头，且 PHP 启用了allow_url_fopen（默认开启，但某些托管环境会禁用） - 如果目标返回 404 或 500，
file_get_contents默认静默失败，需配合get_headers()或curl_getinfo()主动检查状态码 - 大文件容易触发内存溢出或超时，
set_time_limit(0)和ini_set('memory_limit', '256M')得提前加 - 示例片段：
$url = 'https://example.com/assets/logo.png';<br>$content = file_get_contents($url);<br>if ($content === false) {<br> throw new RuntimeException('Failed to fetch ' . $url);<br>}<br>file_put_contents('/var/www/static/logo.png', $content);
用 cURL 下载并校验文件完整性更可靠
当需要处理重定向、Basic Auth、自定义 Header 或校验 MD5/SHA256 时，cURL 是更稳的选择：
- 务必设置
CURLOPT_FOLLOWLOCATION（否则 302 会失败），同时注意open_basedir限制可能影响临时文件写入 - 下载前可先发 HEAD 请求获取
Content-Length和Last-Modified，避免重复拉取未变更的文件 - 下载完成后建议比对远端
ETag或计算本地文件hash_file('sha256', $local_path)，再与服务端提供的哈希值比对 - 不要直接用
CURLOPT_RETURNTRANSFER加大内存缓存整个文件；大文件请用CURLOPT_FILE写入流：$fp = fopen('/tmp/download.tmp', 'w');<br>$ch = curl_init($url);<br>curl_setopt($ch, CURLOPT_FILE, $fp);<br>curl_exec($ch);<br>fclose($fp);
同步前判断是否真要覆盖：用 filemtime() 和 stat() 做轻量决策
盲目覆盖不仅浪费带宽，还可能因并发导致中间态错误。最常用且低成本的判断方式是时间戳 + 大小双校验：
立即学习“PHP免费学习笔记（深入）”；
-
filemtime($local)和远端Last-Modified头对比（注意时区和精度，HTTP 时间戳精确到秒，PHPfilemtime也是秒级） - 若时间一致，再比对
filesize($local)和响应头中的Content-Length；两者都一致就跳过下载 - 慎用
md5_file()全量校验：100MB 文件会阻塞进程数秒，不适合高频同步任务 - 如果远端不返回
Last-Modified（比如 OSS 的某些配置），只能靠定期全量哈希或维护一个远端 manifest.json 列表
真正难的不是“怎么拷”，而是「什么时候不拷」和「出错了怎么退」。同步逻辑一旦上线，就要考虑断点续传、临时文件原子替换（用 rename() 而非直接 file_put_contents 覆盖）、失败后自动重试次数限制——这些细节没包在任何函数里，得自己一行行写清楚。
