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(三处各自改回旧行为 → 断言全变红);
部署脚本静态断言段本地空跑通过。
This commit is contained in:
2026-10-09 08:45:22 +08:00
parent df6fe894d0
commit 5da4de0d20
4 changed files with 101 additions and 8 deletions
+12
View File
@@ -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 去登录页,