feat(links): Mehrteilige Slugs und erhaltene Gross-/Kleinschreibung

Wer bereits gedruckte QR-Codes aus einem anderen System uebernimmt, kann deren Adressen nicht mehr aendern. Sehen die aus wie "/g/1AEJ0X90ZmF", waren sie hier bisher nicht abbildbar: der Normalisierer machte daraus "g-1aej0x90zmf" - Schraegstrich zu Bindestrich, alles klein. Der Kurzlink zeigte damit ins Leere. Ein Slug darf jetzt mehrere durch "/" getrennte Abschnitte haben (hoechstens acht, je 64 Zeichen) und behaelt die eingegebene Schreibweise. Erlaubt sind Buchstaben, Ziffern, Bindestrich, Unterstrich und Punkt; jeder Abschnitt muss mit einem Buchstaben oder einer Ziffer beginnen und enden. Umlaute und Leerzeichen werden weiterhin umgeschrieben. Wird versehentlich eine komplette URL eingefuegt, bleibt davon nur der Pfad uebrig. Damit die Verwaltung nicht verdeckt werden kann, greift die Liste reservierter Namen jetzt auf den ERSTEN Abschnitt: "admin/geheim" wird ebenso abgelehnt wie "admin". Die Route der Weiterleitung steht weiterhin ganz am Ende, alle Verwaltungsrouten gewinnen davor. Bei der Eindeutigkeit gilt bewusst das Gegenteil: sie wird OHNE Ruecksicht auf Gross- und Kleinschreibung geprueft. "Messe" und "messe" koennen auf derselben Domain nicht nebeneinander bestehen - an einer gedruckten Adresse waere sonst nicht mehr erkennbar, welcher Link gemeint ist. Ausserdem wuerde MySQL sie je nach Kollation ohnehin als gleich ansehen, SQLite nicht; so verhalten sich beide Treiber wieder gleich. Beim Aufruf wird zuerst exakt gesucht und nur bei einem Fehlschlag ohne Ruecksicht auf die Schreibweise - abgetippte Codes stimmen nicht immer. Weil die Eindeutigkeit oben schon ohne Ruecksicht geprueft wurde, kann dieser zweite Versuch nie mehrdeutig sein. Geprueft in beiden Betriebsarten: im Container und in der Shared-Hosting-Variante, bei der die Root-.htaccess nach public/ umleitet - dort sind mehrteilige Pfade der wahrscheinlichste Stolperstein.
2026-08-12 18:32:41 +02:00
parent 649f6ba247
commit 583d9f0ae2
9 changed files with 366 additions and 61 deletions
@@ -326,6 +326,95 @@ final class RedirectTest extends TestCase
        self::assertSame(302, $response->status());
    }

+    // --- Mehrteilige Slugs aus fremden Systemen -----------------------
+
+    public function testPathSlugIsStoredAndRedirected(): void
+    {
+        $this->links->create($this->defaultDomainId, 'g/1AEJ0X90ZmF', 'https://www.beispiel.de/uebernommen');
+
+        $response = $this->controller()->handle(
+            $this->request('/g/1AEJ0X90ZmF'),
+            ['slug' => 'g/1AEJ0X90ZmF'],
+        );
+
+        self::assertSame(302, $response->status());
+        self::assertSame('https://www.beispiel.de/uebernommen', $response->headers()['Location']);
+    }
+
+    public function testLetterCaseIsPreservedExactly(): void
+    {
+        $id = $this->links->create($this->defaultDomainId, 'g/1AEJ0X90ZmF', 'https://www.beispiel.de/');
+
+        self::assertSame('g/1AEJ0X90ZmF', $this->links->find($id)['slug']);
+    }
+
+    public function testPathSlugAlsoWorksWithWrongLetterCase(): void
+    {
+        // Abgetippte Codes stimmen nicht immer in der Schreibweise.
+        $this->links->create($this->defaultDomainId, 'g/1AEJ0X90ZmF', 'https://www.beispiel.de/');
+
+        $response = $this->controller()->handle(
+            $this->request('/g/1aej0x90zmf'),
+            ['slug' => 'g/1aej0x90zmf'],
+        );
+
+        self::assertSame(302, $response->status());
+    }
+
+    public function testSlugsDifferingOnlyInCaseAreConsideredTaken(): void
+    {
+        $this->links->create($this->defaultDomainId, 'Messe', 'https://www.beispiel.de/a');
+
+        // Sonst waere an einer gedruckten Adresse nicht mehr erkennbar,
+        // welcher Link gemeint ist.
+        self::assertTrue($this->links->slugExists('messe', $this->defaultDomainId));
+        self::assertTrue($this->links->slugExists('MESSE', $this->defaultDomainId));
+        self::assertTrue($this->links->slugExists('Messe', $this->defaultDomainId));
+        self::assertFalse($this->links->slugExists('messe2', $this->defaultDomainId));
+    }
+
+    public function testPathSlugsAreUniquePerDomain(): void
+    {
+        $qrId = $this->domains->create('https://qr.example.de', null, false);
+
+        $this->links->create($this->defaultDomainId, 'g/ABC', 'https://www.beispiel.de/a');
+
+        self::assertTrue($this->links->slugExists('g/ABC', $this->defaultDomainId));
+        self::assertFalse($this->links->slugExists('g/ABC', $qrId));
+
+        $this->links->create($qrId, 'g/ABC', 'https://www.beispiel.de/b');
+
+        $viaQr = $this->controller()->handle(
+            $this->request('/g/ABC', host: 'qr.example.de'),
+            ['slug' => 'g/ABC'],
+        );
+
+        self::assertSame('https://www.beispiel.de/b', $viaQr->headers()['Location']);
+    }
+
+    public function testUnknownPathSlugGivesFriendly404(): void
+    {
+        $response = $this->controller()->handle(
+            $this->request('/g/gibtesnicht'),
+            ['slug' => 'g/gibtesnicht'],
+        );
+
+        self::assertSame(404, $response->status());
+        self::assertStringContainsString('g/gibtesnicht', $response->body());
+    }
+
+    public function testClicksAreCountedForPathSlugs(): void
+    {
+        $id = $this->links->create($this->defaultDomainId, 'g/1AEJ0X90ZmF', 'https://www.beispiel.de/');
+
+        $this->controller()
+            ->handle($this->request('/g/1AEJ0X90ZmF'), ['slug' => 'g/1AEJ0X90ZmF'])
+            ->runAfterSend();
+
+        self::assertSame(1, (int) $this->links->find($id)['click_count']);
+        self::assertSame(1, $this->visits->totalForLink($id));
+    }
+
    public function testUmlautTargetIsRedirectedAsPunycode(): void
    {
        $this->links->create($this->defaultDomainId, 'umlaut', 'https://müller.de/preise');