从 Apache DavLockDB / WebDAV 获取锁定状态

Question

我运行一个 Apache 网络服务器 mod_dav/mod_dav_fs 在 windows 服务器上。用户可以通过 WebDAV 编辑某些文件。

WebDAV 已设置并且运行目前正确... 问题是，我怎样才能知道当前是否通过 WebDAV 打开了文件以及打开了哪些文件？

Apache 将此信息写入其“DavLockDB”。有没有办法读取该文件或找出当前锁定的文件？

我已经通过 php:

尝试过了

$fp = fopen($file, 'c');
if (!flock($fp, LOCK_EX|LOCK_NB, $wouldblock)) {
    // lock  not obtained
    echo 'file maybe open';
}
else {
    // lock obtained
    echo 'file is free';    
}

如果文件是在服务器本地打开的，这会给我一个正确的结果，但如果文件是通过 WebDAV 打开的，则不会。

有没有人遇到过类似的问题？

亲切的问候托马斯

Answer 1

多年来，我一直被 WebDAV 束缚和沮丧，我经常需要能够识别锁定的文件并偶尔解锁它们。我最近在 PHP 中写了一个小工具来实现这个你可以在 Github.

上看到

我的大部分答案都在 RFC document & on the webdav.org 中找到 site.I 没有遇到使用 DavLockDB 的解决方案，而是按照实际应用程序将 cURL 请求发送到 DAV 服务器的官方路线用于获取我需要的有关文件或目录的信息的 HTTP 动词。

简而言之，您选择一个文件或目录作为端点并发送 PROPFIND 请求。如果端点是一个目录，您将获得资源列表 (files/directories) 及其在该目录中的属性（并且可能在该目录下，具体取决于您的 DEPTH 设置）。如果端点是文件，您将获得文件属性。在这两种情况下，信息都作为 XML 返回，如果任何资源被锁定，属性将包含一个 LockToken。

这里有一个 PHP 函数，您可以根据上述存储库中的方法使用它：

function propfind() {
    $location = 'https://example.com:8000' // ROUTE TO SERVER
    $endpoint = '/webdav/'; // FINAL DESTINATION
    $auth = 'user:pass'; // BASE64 ENCODED USERNAME:PASSWORD
    $url = $location.$endpoint;
    $host = parse_url($location, PHP_URL_HOST);
    $ch = curl_init();
    // FIX LOCALHOST SSL CERTIFICATE ISSUES
    if ($_SERVER['SERVER_NAME'] == 'localhost') curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_VERBOSE, true);
    $verbose = fopen('php://temp', 'w+'); // CREATE A STREAM TO SAVE THE VERBOSE CONNECTION DATA
    curl_setopt($ch, CURLOPT_STDERR, $verbose);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PROPFIND');
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: text/xml; charset="utf-8"',
        'Host: '.$host, 
        'Authorization: Basic '.$auth, 
        'Depth: 1', 
    ));
    /*
    // OPTIONALLY LIMIT THE RESPONSE TO SPECIFIC PROPERTIES
    $xml = '<?xml version="1.0" encoding="utf-8" ?><D:propfind xmlns:D="DAV:"><D:prop><D:creationdate/><D:getlastmodified/><D:getcontentlength/></D:prop></D:propfind>';
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
    */
    $response = curl_exec($ch);
    $curlInfo = curl_getinfo($ch);
    rewind($verbose);
    $verboseLog = stream_get_contents($verbose);
    if(curl_error($ch)) {
        return array('error'=>curl_errno($ch).': '.curl_error($ch), 'response'=>print_r($curlInfo,1), 'verbose'=>$verboseLog);
    }
    curl_close($ch);
    return array($response, $verboseLog);
}

示例响应可能是：

<?xml version="1.0" encoding="utf-8"?>
<D:multistatus xmlns:D="DAV:">
    <D:response xmlns:lp1="DAV:" xmlns:lp2="http://apache.org/dav/props/">
        <D:href>/webdav/test.xlsx</D:href>
        <D:propstat>
            <D:prop>
                <lp1:resourcetype/>
                <lp1:creationdate>2020-04-11T20:30:58Z</lp1:creationdate>
                <lp1:getcontentlength>9853</lp1:getcontentlength>
                <lp1:getlastmodified>Thu, 06 Aug 2020 16:17:05 GMT</lp1:getlastmodified>
                <lp1:getetag>"123456-789b-ab12345cd67e89"</lp1:getetag>
                <lp2:executable>T</lp2:executable>
                <D:supportedlock>
                    <D:lockentry>
                        <D:lockscope><D:exclusive/></D:lockscope>
                        <D:locktype><D:write/></D:locktype>
                    </D:lockentry>
                    <D:lockentry>
                        <D:lockscope><D:shared/></D:lockscope>
                        <D:locktype><D:write/></D:locktype>
                    </D:lockentry>
                </D:supportedlock>
                <D:lockdiscovery>
                    <D:activelock>
                        <D:locktype><D:write/></D:locktype>
                        <D:lockscope><D:exclusive/></D:lockscope>
                        <D:depth>infinity</D:depth>
                        <ns0:owner xmlns:ns0="DAV:"><ns0:href>Username</ns0:href></ns0:owner>
                        <D:timeout>Second-896</D:timeout>
                        <D:locktoken>
                            <D:href>opaquelocktoken:a12bc34d-567e-8901-23d4-5ab6cd7e8f90</D:href>
                        </D:locktoken>
                    </D:activelock>
                </D:lockdiscovery>
                <D:getcontenttype>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</D:getcontenttype>
            </D:prop>
            <D:status>HTTP/1.1 200 OK</D:status>
        </D:propstat>
    </D:response>
</D:multistatus>

注意指示文件已锁定的条目。从理论上讲，您可以递归地使用该函数来映射整个资源并突出显示任何锁定的文件。

要解锁文件，您需要创建锁的用户的凭据。然后使用 UNLOCK 作为 HTTP 动词发送请求：

function unlock () {
    $lockToken = 'opaquelocktoken:a12bc34d-567e-8901-23d4-5ab6cd7e8f90';
    $location = 'https://example.com:8000' // ROUTE TO SERVER
    $endpoint = '/webdav/'; // FINAL DESTINATION
    $auth = 'user:pass'; // BASE64 ENCODED USERNAME:PASSWORD
    $url = $location.$endpoint;
    $host = parse_url($location, PHP_URL_HOST);
    $ch = curl_init();
    // FIX LOCALHOST SSL CERTIFICATE ISSUES
    if ($_SERVER['SERVER_NAME'] == 'localhost') curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'UNLOCK');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Host: '.$host, 
        'Authorization: Basic '.$auth, 
        'Lock-Token: <'.$lockToken.'>', 
    ));
    $response = curl_exec($ch);
    $curlInfo = curl_getinfo($ch);
    if(curl_error($ch)) {
        $unlockStatus = 'ERROR: '.curl_error($ch).print_r($curlInfo,1);
    }
    else {
        $unlockStatus = array(
            'status' => ($curlInfo['http_code'] == '204' ? 'ok' : 'Fail'), 
            'response' => htmlentities($response), 
            'curlInfo' => $curlInfo, 
        );
    }
    curl_close($ch);
    return $unlockStatus;
}

注意：以更手动的方式，您可以使用 2 个 cURL 命令从命令行获取属性和解锁文件：

// GET RESOURCE PROPERTIES
curl -X PROPFIND '{path-to-resource}' -H 'Authorization:Basic {base64 encoded username:password}' -H 'Depth:1'

// UNLOCK A LOCKED FILE
curl -X UNLOCK '{path-to-resource}' -H 'Authorization: Basic {base64 encoded username:password}' -H 'Lock-Token: <{lock-token-from-first-request}>'

从 Apache DavLockDB / WebDAV 获取锁定状态

Obtain lockstate from Apache DavLockDB / WebDAV

php

apache

locking

webdav