v33 第 33 批：DAV（Thunderbird）三处真根因修复

用户原话：
  看看 dav 功能，还是不好用，thunderbird 提示这两个地址下没有任何联系人和日程。

关键教训：v31 那个探针（复刻 SyncCalendar 的 DavClient）线上 28/0 全过，
但用户还是空的 —— 因为 Thunderbird 的请求形状不一样：它真正取数据用的是
REPORT（calendar-multiget / addressbook-multiget），而 v31 探针只走
PROPFIND + GET。复刻了 A 客户端全绿，证明不了 B 客户端能看见东西。

三处真根因（都靠新探针 _fb_dav_tb.py 逐步 dump 原始 XML 抓出）：
① CardDAV 的 REPORT 回的是草案名 <card:address-data>，而 RFC 6352 规定是
   <card:addressbook-data>。Thunderbird 要后者 → 拿到 0 个数据块 → 通讯录永远空。
   修：新增 $cardDataXml 闭包，照客户端点名的属性回正文（没点名默认正式名）。
   注：第一版写成两个都发 → 正文重复一份、e2e 的 BEGIN:VCARD 计数翻倍，改成按需回。
② home-set 的 Depth:1 响应里没有集合自身。RFC 4918 要求 PROPFIND 响应必须包含
   被请求的资源本身，原来只在非 home 请求时才输出 → PROPFIND /dav/calendars/
   只回子本、没有自己 → 严格客户端判 home 不存在 → 一本都看不见。
   修：dav.php / carddav.php 的 home 分支始终先输出集合自身。
③ 站点根 PROPFIND / 被 Apache 交给 index.php → 302 跳登录页 → Thunderbird 判定
   这个域名下没有日历（RFC 6764 允许从域名根发现）。
   修：router.php（本地）+ .htaccess / 部署脚本 5c 段独立标记块（线上）：
   RewriteCond 限住 REQUEST_METHOD + RewriteRule ^$ dav.php；
   必须限方法，否则 GET / 被 ^$ 吞掉、首页 404（已加反向守卫）。
   并让根响应与两个 principal 都给出两套 home-set（calendar + addressbook）。

验证：线上真机 _fb_dav_tb.py 25/0（站点根通 / home-set 含自身 / CardDAV REPORT
真带回 3 个数据块，修复前是 0）；逐本 REPORT 所有集合都能取回数据；
旧诊断（SyncCalendar 序列）28/0 无回归；GET / 仍是 302 未被吞。
本地 e2e 1503/0、v33 DAV 反向验证 7/0（三处各自改回旧行为 → 断言全变红）；
部署脚本静态断言段本地空跑通过。

.htaccess

@@ -28,6 +28,16 @@
 RewriteRule ^\.well-known/caldav$ dav.php [L,QSA]
 RewriteRule ^\.well-known/carddav$ carddav.php [L,QSA]
 
+# 🔴 v33：站点根的 **DAV 方法**也交给 dav.php（RFC 6764 允许从域名根发现）。
+#    病根：`PROPFIND /` 被交给 index.php → 302 跳登录页 → Thunderbird 判定
+#    "这个域名下没有日历"，用户报的就是「提示没有任何联系人和日程」。
+#    ⚠️ 必须用 `RewriteCond` 限住 **REQUEST_METHOD**：不加的话 `GET /` 也会被吞掉、
+#       站点首页直接 404。只放行 PROPFIND/REPORT/OPTIONS 三种 DAV 方法。
+#    ⚠️ 这条要排在下面 `^dav` / `^carddav` **之前**（空 Pattern 匹配的是根，
+#       与那两条前缀互不包含，但先写更清楚）。
+RewriteCond %{REQUEST_METHOD} ^(PROPFIND|REPORT|OPTIONS)$ [NC]
+RewriteRule ^$ dav.php [L,QSA]
+
 # CalDAV：/dav/、/dav/3.ics/、/dav/3.ics/12.ics 全部交给 dav.php
   RewriteRule ^dav(/.*)?$ dav.php [L,QSA]
 

carddav.php

@@ -196,8 +196,27 @@ if ($method === 'PROPFIND') {
     //     ⚠️ `/carddav/` 也走这条路：用户与老客户端都直接把 /carddav/ 当 home 用。
     if ($isHome || $bookId === 0) {
         $parts = [];
-        // 首次请求 `/carddav/`（不是 home 路径）时，把发现链的答案一并给出 ——
+        // 🔴 v33：**始终**先输出 home 集合自身。
-        // 有些客户端在这里**同时**问 current-user-principal，少给一个它就又断了。
+        //    RFC 4918 规定：PROPFIND 的响应**必须包含被请求的资源本身**，
+        //    哪怕 Depth:1 也一样 —— 只有先有"这个集合存在"的证据，
+        //    客户端才会继续读它的成员。原来只在 `!$isHome`（即请求 `/carddav/`）时
+        //    才输出，于是 `PROPFIND /carddav/addressbooks/`（Thunderbird 走的就是这条）
+        //    只回子集、没有自己 ⇒ 严格客户端判定"这个 home 不存在" ⇒ 通讯录空。
+        //    `/carddav/`（不是 home 路径）那一次附带发现链三件套（保持原样）。
+        $parts[] = '<d:response><d:href>' . CardDav::x(CardDav::HOME_PATH) . '</d:href>'
+            . '<d:propstat><d:prop>'
+            . '<d:resourcetype><d:collection/></d:resourcetype>'
+            . '<d:displayname>' . CardDav::x('家书通讯录') . '</d:displayname>'
+            . '<d:current-user-principal><d:href>' . CardDav::x(CardDav::PRINCIPAL_PATH)
+            . '</d:href></d:current-user-principal>'
+            . '<d:principal-URL><d:href>' . CardDav::x(CardDav::PRINCIPAL_PATH)
+            . '</d:href></d:principal-URL>'
+            . '<card:addressbook-home-set><d:href>' . CardDav::x(CardDav::HOME_PATH)
+            . '</d:href></card:addressbook-home-set>'
+            . $readOnlyPriv
+            . '</d:prop></d:propstat></d:response>';
+        // 首次请求 `/carddav/`（不是 home 路径）时，另加一条指向 `/carddav/` 自身的响应，
+        // 客户端会拿它当后续请求的 base。
         if (!$isHome) {
             $parts[] = '<d:response><d:href>/carddav/</d:href>'
                 . '<d:propstat><d:prop>'
@@ -327,6 +346,31 @@ if ($method === 'REPORT') {
     }
     $bodyRaw = (string)file_get_contents('php://input');
 
+    /* 🔴 v33：vCard 正文的属性名要**照客户端点名的那个**回。
+       · `<card:addressbook-data>` 是 **RFC 6352** 的正式名（Thunderbird / Evolution 要它）；
+       · `<card:address-data>` 是早期草案名（老客户端可能还在用）。
+       原来只发旧名 → Thunderbird 收到 0 个数据块、**通讯录永远是空的**
+       （用户报「thunderbird 提示没有任何联系人」的真根因）。
+       ⚠️ 别两个都无脑发：正文会重复一份，客户端侧"卡数"翻倍
+          （e2e 第22条 `BEGIN:VCARD` 计数当场抓到）。
+       ⚠️ 客户端没点名时（如 `addressbook-query` 空 body）默认发**正式名**。 */
+    $cardDataXml = static function (array $card) use ($bodyRaw): string {
+        $wantAB = stripos($bodyRaw, 'addressbook-data') !== false;
+        $wantAD = stripos($bodyRaw, 'address-data') !== false;
+        if (!$wantAB && !$wantAD) {
+            $wantAB = true;                       // 没点名 → RFC 正式名
+        }
+        $body = CardDav::x($card['body'] . "\r\n");   // 结尾 CRLF 只加在正文，不参与 ETag
+        $xml  = '';
+        if ($wantAB) {
+            $xml .= '<card:addressbook-data>' . $body . '</card:addressbook-data>';
+        }
+        if ($wantAD) {
+            $xml .= '<card:address-data>' . $body . '</card:address-data>';
+        }
+        return $xml;
+    };
+
     // 单张卡请求（/carddav/1.vcf/12.vcf）
     if ($cardId > 0) {
         $one = CardDav::one($familyId, $me, $cardId);
@@ -336,15 +380,17 @@ if ($method === 'REPORT') {
         /* ⚠️ 正文与 ETag 都从 cardOf 取（**同一处**算），别在这里另算一次 ——
            v24 第 22 批实测：PROPFIND 用不带结尾 CRLF 的正文算 ETag、这里用带 CRLF 的算，
            同一张卡两个 ETag → 客户端认为它一直在变、反复重拉（同步不收敛）。
-           结尾那条 CRLF 只加在**正文**（address-data 要有完整的 vCard 文本），
+           结尾那条 CRLF 只加在**正文**（数据属性要有完整的 vCard 文本），
-           不参与 ETag。 */
+           不参与 ETag。
+
+           🔴 v33：属性名由 `$cardDataXml` 按客户端点名决定（见上面的闭包）。 */
         $card = CardDav::cardOf($one);
         $emit([
             '<d:response><d:href>'
             . CardDav::x(CardDav::bookHref($bookId) . $cardId . '.vcf') . '</d:href>'
             . '<d:propstat><d:prop>'
             . '<d:getetag>' . CardDav::x($card['etag']) . '</d:getetag>'
-            . '<card:address-data>' . CardDav::x($card['body'] . "\r\n") . '</card:address-data>'
+            . $cardDataXml($card)
             . '</d:prop></d:propstat></d:response>',
         ]);
         exit;
@@ -381,7 +427,7 @@ if ($method === 'REPORT') {
             . CardDav::x(CardDav::bookHref($bookId) . $rid . '.vcf') . '</d:href>'
             . '<d:propstat><d:prop>'
             . '<d:getetag>' . CardDav::x($card['etag']) . '</d:getetag>'
-            . '<card:address-data>' . CardDav::x($card['body'] . "\r\n") . '</card:address-data>'
+            . $cardDataXml($card)
             . '</d:prop></d:propstat></d:response>';
     }
     unset($bodyRaw);

dav.php

@@ -181,14 +181,21 @@ if ($method === 'PROPFIND') {
 
     // 5a. `PROPFIND /`（站点根）→ 只回 current-user-principal。
     //     客户端拿它当"从这个域名开始找 DAV 服务"的起点。
+    //     🔴 v33：同时给出 **两套** home-set（calendar + addressbook）——
+    //       站点根是 CalDAV/CardDAV **共用的**发现起点，客户端只会看自己要的那个属性。
+    //     ⚠️ 光靠这段还不够：线上 Apache 会把 `PROPFIND /` 交给 index.php
+    //        （→ 302 登录页），所以 `.htaccess` 里必须补一条"DAV 方法才转发"的规则。
     if ($isRoot) {
-        $emit('xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:caldav"', [
+        $emit('xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:caldav" '
+              . 'xmlns:card="urn:ietf:params:xml:ns:carddav"', [
             '<d:response><d:href>/</d:href><d:propstat><d:prop>'
             . '<d:resourcetype><d:collection/></d:resourcetype>'
             . '<d:current-user-principal><d:href>' . CalDav::x(CalDav::PRINCIPAL_PATH)
             . '</d:href></d:current-user-principal>'
             . '<c:calendar-home-set><d:href>' . CalDav::x(CalDav::HOME_PATH)
             . '</d:href></c:calendar-home-set>'
+            . '<card:addressbook-home-set><d:href>' . CalDav::x(CalDav::CARD_HOME_PATH)
+            . '</d:href></card:addressbook-home-set>'
             . '</d:prop></d:propstat></d:response>',
         ]);
         exit;
@@ -200,7 +207,8 @@ if ($method === 'PROPFIND') {
     //        本批实测：不回的话，严格按 RFC 走的客户端会在这里判"拿不到 principal"
     //        而中止建账号（探针的"照它报的地址再走一步"那两条正是抓这个的）。
     if ($isPrincipal) {
-        $emit('xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:caldav"', [
+        $emit('xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:caldav" '
+              . 'xmlns:card="urn:ietf:params:xml:ns:carddav"', [
             '<d:response><d:href>' . CalDav::x(CalDav::PRINCIPAL_PATH) . '</d:href>'
             . '<d:propstat><d:prop>'
             . '<d:resourcetype><d:principal/></d:resourcetype>'
@@ -211,6 +219,8 @@ if ($method === 'PROPFIND') {
             . '</d:href></d:principal-URL>'
             . '<c:calendar-home-set><d:href>' . CalDav::x(CalDav::HOME_PATH)
             . '</d:href></c:calendar-home-set>'
+            . '<card:addressbook-home-set><d:href>' . CalDav::x(CalDav::CARD_HOME_PATH)
+            . '</d:href></card:addressbook-home-set>'
             . $readOnlyPriv
             . '</d:prop></d:propstat></d:response>',
         ]);
@@ -235,6 +245,21 @@ if ($method === 'PROPFIND') {
                 . $readOnlyPriv
                 . '</d:prop></d:propstat></d:response>';
         }
+        // 🔴 v33：**始终**先输出 home 集合自身。
+        //    RFC 4918 规定 PROPFIND 响应**必须包含被请求的资源本身**，Depth:1 也是。
+        //    原来只在 `!$isHome`（请求 `/dav/`）时才输出，于是
+        //    `PROPFIND /dav/calendars/`（Thunderbird 走的就是这条）只回子本、没有自己
+        //    ⇒ 严格客户端判定"这个 home 不存在" ⇒ 日历空。
+        $parts[] = '<d:response><d:href>' . CalDav::x(CalDav::HOME_PATH) . '</d:href>'
+            . '<d:propstat><d:prop>'
+            . '<d:resourcetype><d:collection/></d:resourcetype>'
+            . '<d:displayname>' . CalDav::x('家书日历') . '</d:displayname>'
+            . '<d:current-user-principal><d:href>' . CalDav::x(CalDav::PRINCIPAL_PATH)
+            . '</d:href></d:current-user-principal>'
+            . '<c:calendar-home-set><d:href>' . CalDav::x(CalDav::HOME_PATH)
+            . '</d:href></c:calendar-home-set>'
+            . $readOnlyPriv
+            . '</d:prop></d:propstat></d:response>';
         // 首次请求 `/dav/`（bookId=0 且不是 home 路径）时，把发现链的三个答案一并给出：
         // 有些客户端在 /dav/ 上**同时**问 current-user-principal —— 少给一个它就又断了。
         if (!$isHome) {

router.php

@@ -15,6 +15,18 @@
 
 $path = (string)parse_url((string)($_SERVER['REQUEST_URI'] ?? '/'), PHP_URL_PATH);
 
+// 🔴 v33：站点根的 DAV 请求（PROPFIND / REPORT / OPTIONS）→ dav.php。
+//    为什么需要：RFC 6764 允许客户端从**域名根**开始发现 DAV 服务
+//    （`PROPFIND /` 问 current-user-principal），Thunderbird 就会走这条。
+//    Apache 把 `/` 交给 index.php（→ 302 登录页），客户端判定"这里没有日历"。
+//    ⇒ 只对 **DAV 方法**转发，`GET /` 仍是站点首页（绝不能把首页吞掉）。
+//    ⚠️ 线上等价物在 `.htaccess` 里（RewriteCond 判 REQUEST_METHOD）。
+$method = strtoupper((string)($_SERVER['REQUEST_METHOD'] ?? 'GET'));
+if (($path === '/' || $path === '') && in_array($method, ['PROPFIND', 'REPORT', 'OPTIONS'], true)) {
+    require __DIR__ . '/dav.php';
+    return true;
+}
+
 // 🔴 v31：`/.well-known/caldav` 与 `/.well-known/carddav`（RFC 6764）。
 //    标准客户端（DAVx⁵ / iOS / Evolution）添加账号时**第一句**就试这里 ——
 //    原来没有这条路由，于是落到 index.php、被 302 去登录页，