php 8.6列出webdav目录时,可以发送depth为1的propfind请求,读取当前目录及直接子项的属性,再按dav命名空间解析多状态xml响应。这适合取得文件路径、大小和修改时间,不需要先下载每个文件正文,也不会修改远端文件。

官方文档:WebDAV按需请求文件属性
准备Nextcloud文件端点
以已部署Nextcloud为例,账号文件目录使用/remote.php/dav/files/{user}/路径。应用账号和应用密码通过运行环境提供,端点固定为自己的HTTPS服务;PHP需启用cURL、SimpleXML和libxml。
Depth: 0只请求当前节点属性,Depth: 1包含直接子项。不要对很大的目录盲目使用无限深度;需要递归清点时,应另设目录数量、总条目数和执行时间上限。

官方文档:WebDAV目录列举和Depth请求
请求属性并解析成功的属性组
<?php $url = getenv('WEBDAV_DIRECTORY_URL');
$request = '<?xml version="1.0" encoding="UTF-8"?>'
. '<propfind xmlns:d="DAV:"><prop><getcontentlength></getcontentlength>'
. '<getlastmodified></getlastmodified><resourcetype></resourcetype></prop></propfind>';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'PROPFIND',
CURLOPT_POSTFIELDS => $request,
CURLOPT_USERPWD => getenv('WEBDAV_USER') . ':' . getenv('WEBDAV_APP_PASSWORD'),
CURLOPT_HTTPHEADER => ['Depth: 1', 'Content-Type: application/xml; charset=utf-8'],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 30,
]);
try {
$body = curl_exec($ch);
if ($body === false || curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 207) {
throw new RuntimeException('目录属性请求失败');
}
} finally {
curl_close($ch);
}
if (strlen($body) > 5 * 1024 * 1024 || stripos($body, ') !== false) {
throw new RuntimeException('XML超过限制或含有不接受的DTD');
}
$xml = simplexml_load_string($body, SimpleXMLElement::class, LIBXML_NONET);
if ($xml === false) throw new RuntimeException('无效XML');
$xml->registerXPathNamespace('d', 'DAV:');
foreach ($xml->xpath('/d:multistatus/d:response') as $node) {
$dav = $node->children('DAV:');
foreach ($dav->propstat as $group) {
if (!preg_match('/\s200\s/', (string) $group->status)) continue;
$props = $group->prop;
echo json_encode([
'href' => (string) $dav->href,
'is_directory' => isset($props->resourcetype->collection),
'size' => isset($props->getcontentlength) ? (string) $props->getcontentlength : null,
'modified' => (string) $props->getlastmodified,
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
}
}
207表示响应包含多个资源或属性状态,不代表所有属性都成功。代码仅消费状态200的propstat组;目录通常没有与普通文件相同的长度属性,因此保留null而不虚构为0字节文件。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
核对目录自身和子项
Depth为1时结果通常包含目录自身。界面若只显示子项,应把响应href规范化后与请求目录路径比较,再排除自身;不要简单删掉第一条,因为响应顺序不是业务身份标识。
href是资源定位信息,显示时按文本转义,后续下载也只允许访问配置好的服务域与授权路径。示例的大小检查发生在收取响应后;面对不受控服务或超大目录,应改为有总字节上限的流式接收或后台任务,避免先占满内存。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










