Publication initiale de RelaisSMS : documentation et sources nettoyees

2026-10-21 09:29:39 +02:00
commit ac186b03b1
158 changed files with 24818 additions and 0 deletions
@@ -0,0 +1,213 @@
+<?php
+
+namespace App\Services\CardDav;
+
+use App\Contracts\CardDav\CardDavClientInterface;
+use GuzzleHttp\ClientInterface;
+use GuzzleHttp\Exception\GuzzleException;
+use RuntimeException;
+use SimpleXMLElement;
+use Throwable;
+
+class CardDavClient implements CardDavClientInterface
+{
+    public function __construct(
+        private readonly ClientInterface $http,
+    ) {}
+
+    public function fetchCards(): array
+    {
+        try {
+            $cards = $this->fetchCardsWithReport();
+
+            if ($cards !== []) {
+                return $cards;
+            }
+        } catch (GuzzleException|RuntimeException) {
+            // Some CardDAV servers restrict addressbook-query. Fall back to PROPFIND + GET.
+        }
+
+        return $this->fetchCardsWithPropfind();
+    }
+
+    /**
+     * @return array<int, CardDavRemoteCard>
+     */
+    private function fetchCardsWithReport(): array
+    {
+        $url = rtrim((string) config('relais_sms.carddav.url'), '/').'/';
+        $username = (string) config('relais_sms.carddav.username');
+        $password = (string) config('relais_sms.carddav.password');
+
+        $this->ensureConfigured($url, $username, $password);
+
+        $response = $this->http->request('REPORT', $url, [
+            'auth' => [$username, $password],
+            'headers' => [
+                'Content-Type' => 'application/xml; charset=utf-8',
+                'Depth' => '1',
+            ],
+            'body' => <<<'XML'
+<?xml version="1.0" encoding="utf-8" ?>
+<c:addressbook-query xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:carddav">
+  <d:prop>
+    <d:getetag />
+    <c:address-data />
+  </d:prop>
+</c:addressbook-query>
+XML,
+            'timeout' => (float) config('relais_sms.carddav.timeout'),
+        ]);
+
+        return $this->parseReport((string) $response->getBody());
+    }
+
+    /**
+     * @return array<int, CardDavRemoteCard>
+     */
+    private function fetchCardsWithPropfind(): array
+    {
+        $url = rtrim((string) config('relais_sms.carddav.url'), '/').'/';
+        $username = (string) config('relais_sms.carddav.username');
+        $password = (string) config('relais_sms.carddav.password');
+
+        $this->ensureConfigured($url, $username, $password);
+
+        $response = $this->http->request('PROPFIND', $url, [
+            'auth' => [$username, $password],
+            'headers' => [
+                'Content-Type' => 'application/xml; charset=utf-8',
+                'Depth' => '1',
+            ],
+            'body' => <<<'XML'
+<?xml version="1.0" encoding="utf-8" ?>
+<d:propfind xmlns:d="DAV:">
+  <d:prop>
+    <d:getetag />
+  </d:prop>
+</d:propfind>
+XML,
+            'timeout' => (float) config('relais_sms.carddav.timeout'),
+        ]);
+
+        $entries = $this->parsePropfind((string) $response->getBody(), $url);
+        $cards = [];
+
+        foreach ($entries as $entry) {
+            $cardResponse = $this->http->request('GET', $entry['url'], [
+                'auth' => [$username, $password],
+                'headers' => [
+                    'Accept' => 'text/vcard,text/x-vcard,text/plain,*/*',
+                ],
+                'timeout' => (float) config('relais_sms.carddav.timeout'),
+            ]);
+
+            $cards[] = new CardDavRemoteCard(
+                href: $entry['href'],
+                etag: $entry['etag'],
+                vcard: (string) $cardResponse->getBody(),
+            );
+        }
+
+        return $cards;
+    }
+
+    private function ensureConfigured(string $url, string $username, string $password): void
+    {
+        if ($url === '/' || $username === '' || $password === '') {
+            throw new RuntimeException('Configuration CardDAV incomplete.');
+        }
+    }
+
+    /**
+     * @return array<int, CardDavRemoteCard>
+     */
+    private function parseReport(string $xml): array
+    {
+        try {
+            $document = new SimpleXMLElement($xml);
+        } catch (Throwable $exception) {
+            throw new RuntimeException('Reponse CardDAV REPORT illisible.', previous: $exception);
+        }
+
+        $document->registerXPathNamespace('d', 'DAV:');
+        $responses = $document->xpath('//d:response') ?: [];
+        $cards = [];
+
+        foreach ($responses as $response) {
+            $response->registerXPathNamespace('d', 'DAV:');
+            $response->registerXPathNamespace('c', 'urn:ietf:params:xml:ns:carddav');
+
+            $hrefNodes = $response->xpath('./d:href') ?: [];
+            $cardNodes = $response->xpath('.//c:address-data') ?: [];
+            $href = trim((string) ($hrefNodes[0] ?? ''));
+            $vcard = (string) ($cardNodes[0] ?? '');
+
+            if ($href === '' || trim($vcard) === '') {
+                continue;
+            }
+
+            $etagNodes = $response->xpath('.//d:getetag') ?: [];
+            $cards[] = new CardDavRemoteCard(
+                href: $href,
+                etag: trim((string) ($etagNodes[0] ?? ''), '"') ?: null,
+                vcard: $vcard,
+            );
+        }
+
+        return $cards;
+    }
+
+    /**
+     * @return array<int, array{href: string, etag: ?string, url: string}>
+     */
+    private function parsePropfind(string $xml, string $baseUrl): array
+    {
+        try {
+            $document = new SimpleXMLElement($xml);
+        } catch (Throwable $exception) {
+            throw new RuntimeException('Reponse CardDAV PROPFIND illisible.', previous: $exception);
+        }
+
+        $document->registerXPathNamespace('d', 'DAV:');
+        $responses = $document->xpath('//d:response') ?: [];
+        $entries = [];
+
+        foreach ($responses as $response) {
+            $response->registerXPathNamespace('d', 'DAV:');
+            $hrefNodes = $response->xpath('./d:href') ?: [];
+            $href = trim((string) ($hrefNodes[0] ?? ''));
+
+            if ($href === '' || ! str_ends_with(strtolower(parse_url($href, PHP_URL_PATH) ?: $href), '.vcf')) {
+                continue;
+            }
+
+            $etagNodes = $response->xpath('.//d:getetag') ?: [];
+            $entries[] = [
+                'href' => $href,
+                'etag' => trim((string) ($etagNodes[0] ?? ''), '"') ?: null,
+                'url' => $this->absoluteUrl($baseUrl, $href),
+            ];
+        }
+
+        return $entries;
+    }
+
+    private function absoluteUrl(string $baseUrl, string $href): string
+    {
+        if (parse_url($href, PHP_URL_SCHEME)) {
+            return $href;
+        }
+
+        $base = parse_url($baseUrl);
+
+        if (! isset($base['scheme'], $base['host'])) {
+            throw new RuntimeException('URL CardDAV invalide.');
+        }
+
+        $port = isset($base['port']) ? ':'.$base['port'] : '';
+        $path = str_starts_with($href, '/') ? $href : rtrim((string) ($base['path'] ?? ''), '/').'/'.$href;
+
+        return $base['scheme'].'://'.$base['host'].$port.$path;
+    }
+}