php 8.6通过curl覆盖webdav资源时,可以把已读取的强etag原样放进if-match头,让服务器只在版本仍一致时接受put。返回412表示前置条件失败,应重新读取并由用户决定合并,不应去掉条件后自动覆盖;服务器必须实际支持相应的条件请求语义。

MDN文档中的If-Match header
把已知ETag随上传请求提交
<?php $url='https://dav.example.com/documents/report.txt'; // 固定、受信任服务器
$etag='"server-returned-strong-etag"'; // 替换为上次GET/HEAD真实响应值
if (str_starts_with($etag,'W/') || preg_match('/[\r\n]/',$etag))
throw new InvalidArgumentException('需要完整强ETag');
$fp=fopen('/srv/app-export/report.txt','rb');
if ($fp===false) throw new RuntimeException('无法打开本地文件');
$size=fstat($fp)['size'];$ch=curl_init($url);
try {
curl_setopt_array($ch,[CURLOPT_UPLOAD=>true,CURLOPT_INFILE=>$fp,
CURLOPT_INFILESIZE=>$size,CURLOPT_HTTPHEADER=>['If-Match: '.$etag],
CURLOPT_USERPWD=>getenv('DAV_USER').':'.getenv('DAV_PASSWORD'),
CURLOPT_CONNECTTIMEOUT=>5,CURLOPT_TIMEOUT=>30,CURLOPT_RETURNTRANSFER=>true,
CURLOPT_FOLLOWLOCATION=>false]);
$response=curl_exec($ch);
if ($response===false) throw new RuntimeException('上传传输失败');
$status=curl_getinfo($ch,CURLINFO_RESPONSE_CODE);
if ($status===412) throw new RuntimeException('远端版本已变化,请重新读取');
if ($status=300) throw new RuntimeException('上传被拒绝:'.$status);
} finally {fclose($fp);}

cURL官方文档中的CURLOPT_UPLOAD explained
保留引号,拒绝弱ETag和未审查跳转
ETag是服务器生成的不透明版本标识,不自行计算文件哈希来替代,也不删除响应值外层引号。If-Match使用强比较;W/开头的弱标识不适合这个覆盖条件。保持TLS证书校验,凭据不写入日志,并限制上传目的地址。关闭自动跳转可避免凭据和数据被转到未经审查的位置。
区分覆盖、创建和未知结果
只想创建一个尚不存在的资源时应单独采用If-None-Match: *,不要与已有资源的If-Match混用。网络超时可能发生在服务端已写入之后,应先读取远端状态核查,不能直接改条件重传。2xx表示这次PUT获接受;如需保存下一次更新使用的ETag,应从实际响应或后续读取获得,不能继续复用旧版本号。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










