从Apache DavLockDB / WebDAV获取锁定状态

问题描述

我在Windows服务器上运行带有mod_dav / mod_dav_fs的Apache Web服务器。用户可以通过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打开了文件，则不会。

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

亲切的问候托马斯

解决方法

多年来，我一直受WebDAV的束缚和沮丧，而且我经常需要能够识别锁定的文件并偶尔对其进行解锁。我最近在PHP中编写了一个小工具来实现这一目标，您可以在Github上看到它。

我的大部分答案都在RFC document和webdav.org网站上找到。我没有遇到使用DavLockDB的解决方案，而是走了正式路线，将cURL请求发送给DAV服务器真正的应用程序将使用HTTP动词来获取我需要的有关文件或目录的信息。

简而言之，您选择一个文件或目录作为端点并发送PROPFIND请求。如果端点是目录，则将获得该目录中的资源（文件/目录）及其属性的列表（取决于您的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,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,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,'UNLOCK');
    curl_setopt($ch,array(
        'Host: '.$host,'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;
}

NB：以更手动的方式，您可以使用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 locking webdav