diff --git a/.htaccess b/.htaccess index 8e8bc08..360b382 100644 --- a/.htaccess +++ b/.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] diff --git a/carddav.php b/carddav.php index c081a13..163dde5 100644 --- a/carddav.php +++ b/carddav.php @@ -196,8 +196,27 @@ if ($method === 'PROPFIND') { // ⚠️ `/carddav/` 也走这条路：用户与老客户端都直接把 /carddav/ 当 home 用。 if ($isHome || $bookId === 0) { $parts = []; - // 首次请求 `/carddav/`（不是 home 路径）时，把发现链的答案一并给出 —— - // 有些客户端在这里**同时**问 current-user-principal，少给一个它就又断了。 + // 🔴 v33：**始终**先输出 home 集合自身。 + // RFC 4918 规定：PROPFIND 的响应**必须包含被请求的资源本身**， + // 哪怕 Depth:1 也一样 —— 只有先有"这个集合存在"的证据， + // 客户端才会继续读它的成员。原来只在 `!$isHome`（即请求 `/carddav/`）时 + // 才输出，于是 `PROPFIND /carddav/addressbooks/`（Thunderbird 走的就是这条） + // 只回子集、没有自己 ⇒ 严格客户端判定"这个 home 不存在" ⇒ 通讯录空。 + // `/carddav/`（不是 home 路径）那一次附带发现链三件套（保持原样）。 + $parts[] = '' . CardDav::x(CardDav::HOME_PATH) . '' + . '' + . '' + . '' . CardDav::x('家书通讯录') . '' + . '' . CardDav::x(CardDav::PRINCIPAL_PATH) + . '' + . '' . CardDav::x(CardDav::PRINCIPAL_PATH) + . '' + . '' . CardDav::x(CardDav::HOME_PATH) + . '' + . $readOnlyPriv + . ''; + // 首次请求 `/carddav/`（不是 home 路径）时，另加一条指向 `/carddav/` 自身的响应， + // 客户端会拿它当后续请求的 base。 if (!$isHome) { $parts[] = '/carddav/' . '' @@ -327,6 +346,31 @@ if ($method === 'REPORT') { } $bodyRaw = (string)file_get_contents('php://input'); + /* 🔴 v33：vCard 正文的属性名要**照客户端点名的那个**回。 + · `` 是 **RFC 6352** 的正式名（Thunderbird / Evolution 要它）； + · `` 是早期草案名（老客户端可能还在用）。 + 原来只发旧名 → 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 .= '' . $body . ''; + } + if ($wantAD) { + $xml .= '' . $body . ''; + } + 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 文本）， - 不参与 ETag。 */ + 结尾那条 CRLF 只加在**正文**（数据属性要有完整的 vCard 文本）， + 不参与 ETag。 + + 🔴 v33：属性名由 `$cardDataXml` 按客户端点名决定（见上面的闭包）。 */ $card = CardDav::cardOf($one); $emit([ '' . CardDav::x(CardDav::bookHref($bookId) . $cardId . '.vcf') . '' . '' . '' . CardDav::x($card['etag']) . '' - . '' . CardDav::x($card['body'] . "\r\n") . '' + . $cardDataXml($card) . '', ]); exit; @@ -381,7 +427,7 @@ if ($method === 'REPORT') { . CardDav::x(CardDav::bookHref($bookId) . $rid . '.vcf') . '' . '' . '' . CardDav::x($card['etag']) . '' - . '' . CardDav::x($card['body'] . "\r\n") . '' + . $cardDataXml($card) . ''; } unset($bodyRaw); diff --git a/dav.php b/dav.php index ff9cba4..e5dc74a 100644 --- a/dav.php +++ b/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"', [ '/' . '' . '' . CalDav::x(CalDav::PRINCIPAL_PATH) . '' . '' . CalDav::x(CalDav::HOME_PATH) . '' + . '' . CalDav::x(CalDav::CARD_HOME_PATH) + . '' . '', ]); 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"', [ '' . CalDav::x(CalDav::PRINCIPAL_PATH) . '' . '' . '' @@ -211,6 +219,8 @@ if ($method === 'PROPFIND') { . '' . '' . CalDav::x(CalDav::HOME_PATH) . '' + . '' . CalDav::x(CalDav::CARD_HOME_PATH) + . '' . $readOnlyPriv . '', ]); @@ -235,6 +245,21 @@ if ($method === 'PROPFIND') { . $readOnlyPriv . ''; } + // 🔴 v33：**始终**先输出 home 集合自身。 + // RFC 4918 规定 PROPFIND 响应**必须包含被请求的资源本身**，Depth:1 也是。 + // 原来只在 `!$isHome`（请求 `/dav/`）时才输出，于是 + // `PROPFIND /dav/calendars/`（Thunderbird 走的就是这条）只回子本、没有自己 + // ⇒ 严格客户端判定"这个 home 不存在" ⇒ 日历空。 + $parts[] = '' . CalDav::x(CalDav::HOME_PATH) . '' + . '' + . '' + . '' . CalDav::x('家书日历') . '' + . '' . CalDav::x(CalDav::PRINCIPAL_PATH) + . '' + . '' . CalDav::x(CalDav::HOME_PATH) + . '' + . $readOnlyPriv + . ''; // 首次请求 `/dav/`（bookId=0 且不是 home 路径）时，把发现链的三个答案一并给出： // 有些客户端在 /dav/ 上**同时**问 current-user-principal —— 少给一个它就又断了。 if (!$isHome) { diff --git a/router.php b/router.php index 6d5c7b2..2c4eb46 100644 --- a/router.php +++ b/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 去登录页，