Add support for browser redirect conditions

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         php-version: ['8.4', '8.5']
-        shlink-version: ['5.0', '4.6', '4.5', '4.4', '4.3', '4.2', '4.1', '4.0']
+        shlink-version: ['5.1', '5.0', '4.6', '4.5', '4.4', '4.3', '4.2', '4.1', '4.0']
         shlink-api-version: ['3']
     steps:
       - name: Checkout code

CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com), and this project adheres to [Semantic Versioning](https://semver.org).
 
+## [3.3.0] - 2026-06-12
+### Added
+* Add support for `browser` redirect conditions, which were introduced in Shlink 5.1.0
+
+### Changed
+* *Nothing*
+
+### Deprecated
+* *Nothing*
+
+### Removed
+* *Nothing*
+
+### Fixed
+* *Nothing*
+
+
 ## [3.2.0] - 2026-05-22
 ### Added
 * *Nothing*

Dockerfile

@@ -1,7 +1,7 @@
 FROM composer:2
 
+COPY --from=ghcr.io/php/pie:bin /pie /usr/bin/pie
 RUN apk add --update linux-headers && \
     apk add --no-cache --virtual .phpize-deps ${PHPIZE_DEPS} && \
-    pecl install xdebug && \
-    docker-php-ext-enable xdebug && \
+    pie install xdebug/xdebug && \
     apk del .phpize-deps

src/RedirectRules/Model/RedirectCondition.php

@@ -6,6 +6,7 @@
 
 use DateTimeInterface;
 use JsonSerializable;
+use Shlinkio\Shlink\SDK\ShortUrls\Model\Browser;
 use Shlinkio\Shlink\SDK\ShortUrls\Model\Device;
 
 final readonly class RedirectCondition implements JsonSerializable
@@ -71,6 +72,11 @@ public static function forAfterDate(DateTimeInterface $date): self
         return new self(RedirectConditionType::AFTER_DATE, $date->format(DateTimeInterface::ATOM));
     }
 
+    public static function forBrowser(Browser $browser): self
+    {
+        return new self(RedirectConditionType::BROWSER, $browser->value);
+    }
+
     public static function fromArray(array $payload): self
     {
         $originalType = $payload['type'] ?? '';

src/RedirectRules/Model/RedirectConditionType.php

@@ -16,5 +16,6 @@ enum RedirectConditionType: string
     case GEOLOCATION_CITY_NAME = 'geolocation-city-name';
     case BEFORE_DATE = 'before-date';
     case AFTER_DATE = 'after-date';
+    case BROWSER = 'browser';
     case UNKNOWN = 'unknown';
 }

src/ShortUrls/Model/Browser.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shlinkio\Shlink\SDK\ShortUrls\Model;
+
+enum Browser: string
+{
+    case CHROME = 'chrome';
+    case FIREFOX = 'firefox';
+    case EDGE = 'edge';
+    case SAFARI = 'safari';
+    case OPERA = 'opera';
+    case ANDROID_BROWSER = 'android_browser';
+}

test/RedirectRules/Model/RedirectConditionTest.php

@@ -10,6 +10,7 @@
 use PHPUnit\Framework\TestCase;
 use Shlinkio\Shlink\SDK\RedirectRules\Model\RedirectCondition;
 use Shlinkio\Shlink\SDK\RedirectRules\Model\RedirectConditionType;
+use Shlinkio\Shlink\SDK\ShortUrls\Model\Browser;
 use Shlinkio\Shlink\SDK\ShortUrls\Model\Device;
 
 class RedirectConditionTest extends TestCase
@@ -97,6 +98,16 @@ public function forDeviceCreatesExpectedCondition(): void
         self::assertNull($condition->matchKey);
     }
 
+    #[Test]
+    public function forBrowserCreatesExpectedCondition(): void
+    {
+        $condition = RedirectCondition::forBrowser(Browser::CHROME);
+
+        self::assertEquals(RedirectConditionType::BROWSER, $condition->type);
+        self::assertEquals(Browser::CHROME->value, $condition->matchValue);
+        self::assertNull($condition->matchKey);
+    }
+
     #[Test]
     public function forIpAddressCreatesExpectedCondition(): void
     {