From bddd83865cece9004e5ef4386a9b3f6d4e54701b Mon Sep 17 00:00:00 2001 From: Martin Linzmayer Date: Wed, 18 Nov 2026 23:30:30 +0100 Subject: [PATCH 1/3] feat: add user resolver --- src/State/Scope.php | 59 ++++++++++++++++++++-- tests/State/ScopeTest.php | 103 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 158 insertions(+), 4 deletions(-) diff --git a/src/State/Scope.php b/src/State/Scope.php index e771953dc..b35b97623 100644 --- a/src/State/Scope.php +++ b/src/State/Scope.php @@ -45,6 +45,11 @@ class Scope */ private $user; + /** + * @var (callable(): (UserDataBag|null))|null The callable that resolves the user each time it is read + */ + private $userResolver; + /** * @var array> The list of contexts associated to this scope */ @@ -248,7 +253,49 @@ public function setExtras(array $extras): self */ public function getUser(): ?UserDataBag { - return $this->user; + if ($this->userResolver === null) { + return $this->user; + } + + $userResolver = $this->userResolver; + // unset the callback to prevent recursion in case getUser is called in the callback + $this->userResolver = null; + + try { + $resolvedUser = $userResolver(); + } catch (\Throwable $exception) { + $resolvedUser = null; + } finally { + $this->userResolver = $userResolver; + } + + if ($resolvedUser === null || $this->user === null) { + return $this->user ?? $resolvedUser; + } + + $user = clone $this->user; + $user->setId($user->getId() ?? $resolvedUser->getId()); + $user->setEmail($user->getEmail() ?? $resolvedUser->getEmail()); + $user->setUsername($user->getUsername() ?? $resolvedUser->getUsername()); + $user->setIpAddress($user->getIpAddress() ?? $resolvedUser->getIpAddress()); + + return (clone $resolvedUser)->merge($user); + } + + /** + * Sets a callable that resolves the user each time it is read, which + * happens for every event, log and metric, so it should be cheap. The + * data set on the scope takes precedence over the data it returns. + * + * @param callable(): (UserDataBag|null) $userResolver + * + * @return $this + */ + public function setUserResolver(callable $userResolver): self + { + $this->userResolver = $userResolver; + + return $this; } /** @@ -285,6 +332,7 @@ public function setUser($user): self public function removeUser(): self { $this->user = null; + $this->userResolver = null; return $this; } @@ -439,6 +487,7 @@ public static function getExternalPropagationContext(): ?array public function clear(): self { $this->user = null; + $this->userResolver = null; $this->level = null; $this->span = null; $this->fingerprint = []; @@ -489,13 +538,15 @@ public function applyToEvent(Event $event, ?EventHint $hint = null, ?Options $op $event->setExtra(array_merge($this->extra, $event->getExtra())); } - if ($this->user !== null) { + $scopeUser = $this->getUser(); + + if ($scopeUser !== null) { $user = $event->getUser(); if ($user === null) { - $user = $this->user; + $user = $scopeUser; } else { - $user = $this->user->merge($user); + $user = $scopeUser->merge($user); } $event->setUser($user); diff --git a/tests/State/ScopeTest.php b/tests/State/ScopeTest.php index de9b1a621..beb0c0c5f 100644 --- a/tests/State/ScopeTest.php +++ b/tests/State/ScopeTest.php @@ -305,6 +305,106 @@ public function testSetUserThrowsOnInvalidArgument(): void $scope->setUser('foo'); } + public function testSetUserResolver(): void + { + $scope = new Scope(); + $scope->setUser(UserDataBag::createFromUserIpAddress('127.0.0.1')); + + $resolvable = false; + $calls = 0; + + $scope->setUserResolver(static function () use (&$resolvable, &$calls): ?UserDataBag { + ++$calls; + + return $resolvable ? UserDataBag::createFromUserIdentifier('unique_id') : null; + }); + + $this->assertEquals(UserDataBag::createFromUserIpAddress('127.0.0.1'), $scope->getUser()); + $this->assertSame(1, $calls); + + $resolvable = true; + + $event = $scope->applyToEvent(Event::createEvent()); + + $this->assertNotNull($event); + $this->assertEquals(UserDataBag::createFromArray(['id' => 'unique_id', 'ip_address' => '127.0.0.1']), $event->getUser()); + $this->assertSame(2, $calls); + + $resolvable = false; + + $this->assertEquals(UserDataBag::createFromUserIpAddress('127.0.0.1'), $scope->getUser()); + } + + public function testSetUserResolverDoesNotOverrideTheUser(): void + { + $scope = new Scope(); + $scope->setUser(['id' => 'unique_id', 'subscription' => 'basic']); + + $scope->setUserResolver(static function (): UserDataBag { + return UserDataBag::createFromArray([ + 'id' => 'resolved_id', + 'email' => 'foo@example.com', + 'subscription' => 'pro', + 'plan' => 'yearly', + ]); + }); + + $this->assertEquals( + UserDataBag::createFromArray([ + 'id' => 'unique_id', + 'email' => 'foo@example.com', + 'subscription' => 'basic', + 'plan' => 'yearly', + ]), + $scope->getUser() + ); + } + + public function testSetUserResolverKeepsTheUserIfTheResolverThrows(): void + { + $scope = new Scope(); + $scope->setUser(UserDataBag::createFromUserIpAddress('127.0.0.1')); + + $scope->setUserResolver(static function (): UserDataBag { + throw new \RuntimeException('foo'); + }); + + $this->assertEquals(UserDataBag::createFromUserIpAddress('127.0.0.1'), $scope->getUser()); + } + + public function testSetUserResolverIsNotCalledAgainWhileItRuns(): void + { + $scope = new Scope(); + $calls = 0; + + $scope->setUserResolver(static function () use ($scope, &$calls): ?UserDataBag { + ++$calls; + + return $scope->getUser(); + }); + + $this->assertNull($scope->getUser()); + $this->assertSame(1, $calls); + + $scope->getUser(); + + $this->assertSame(2, $calls); + } + + public function testRemoveUserRemovesTheUserResolver(): void + { + $scope = new Scope(); + $scope->setUserResolver(static function (): UserDataBag { + return UserDataBag::createFromUserIdentifier('unique_id'); + }); + + $this->assertEquals(UserDataBag::createFromUserIdentifier('unique_id'), $scope->getUser()); + + $scope->removeUser(); + + $this->assertNull($scope->getUser()); + } + public function testRemoveUser(): void { $scope = new Scope(); @@ -523,6 +623,9 @@ public function testClear(): void $scope->setTags(['bar' => 'foo']); $scope->addFeatureFlag('feature', true); $scope->setUser(UserDataBag::createFromUserIdentifier('unique_id')); + $scope->setUserResolver(static function (): UserDataBag { + return UserDataBag::createFromUserIdentifier('resolved_id'); + }); $scope->clear(); $event = $scope->applyToEvent(Event::createEvent()); From db064f586723bdeb085511e89b6e2929577efcf3 Mon Sep 17 00:00:00 2001 From: Martin Linzmayer Date: Wed, 18 Nov 2026 23:45:32 +0100 Subject: [PATCH 2/3] fix --- analysis-baseline.toml | 12 ++++++++++++ src/State/Scope.php | 1 + tests/State/ScopeTest.php | 2 ++ 3 files changed, 15 insertions(+) diff --git a/analysis-baseline.toml b/analysis-baseline.toml index 2c8f8507a..0c1a8d183 100644 --- a/analysis-baseline.toml +++ b/analysis-baseline.toml @@ -1260,6 +1260,18 @@ code = "possibly-null-operand" message = "Left operand in `<` comparison might be `null` (type `float|null`)." count = 1 +[[issues]] +file = "src/State/Scope.php" +code = "deprecated-method" +message = 'Call to deprecated method: `Sentry\UserDataBag::getSegment`.' +count = 2 + +[[issues]] +file = "src/State/Scope.php" +code = "deprecated-method" +message = 'Call to deprecated method: `Sentry\UserDataBag::setSegment`.' +count = 1 + [[issues]] file = "src/State/Scope.php" code = "impossible-condition" diff --git a/src/State/Scope.php b/src/State/Scope.php index b35b97623..49d1c7f07 100644 --- a/src/State/Scope.php +++ b/src/State/Scope.php @@ -278,6 +278,7 @@ public function getUser(): ?UserDataBag $user->setEmail($user->getEmail() ?? $resolvedUser->getEmail()); $user->setUsername($user->getUsername() ?? $resolvedUser->getUsername()); $user->setIpAddress($user->getIpAddress() ?? $resolvedUser->getIpAddress()); + $user->setSegment($user->getSegment() ?? $resolvedUser->getSegment()); return (clone $resolvedUser)->merge($user); } diff --git a/tests/State/ScopeTest.php b/tests/State/ScopeTest.php index beb0c0c5f..8a5fb55d6 100644 --- a/tests/State/ScopeTest.php +++ b/tests/State/ScopeTest.php @@ -344,6 +344,7 @@ public function testSetUserResolverDoesNotOverrideTheUser(): void return UserDataBag::createFromArray([ 'id' => 'resolved_id', 'email' => 'foo@example.com', + 'segment' => 'my_segment', 'subscription' => 'pro', 'plan' => 'yearly', ]); @@ -353,6 +354,7 @@ public function testSetUserResolverDoesNotOverrideTheUser(): void UserDataBag::createFromArray([ 'id' => 'unique_id', 'email' => 'foo@example.com', + 'segment' => 'my_segment', 'subscription' => 'basic', 'plan' => 'yearly', ]), From 343470ac67187b34fba325c02cc9e73f939679f8 Mon Sep 17 00:00:00 2001 From: Martin Linzmayer Date: Wed, 18 Nov 2026 23:53:35 +0100 Subject: [PATCH 3/3] fix --- src/State/Scope.php | 8 ++++++-- tests/State/ScopeTest.php | 17 +++++++++++++++++ 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/src/State/Scope.php b/src/State/Scope.php index 49d1c7f07..911c918a6 100644 --- a/src/State/Scope.php +++ b/src/State/Scope.php @@ -269,8 +269,12 @@ public function getUser(): ?UserDataBag $this->userResolver = $userResolver; } - if ($resolvedUser === null || $this->user === null) { - return $this->user ?? $resolvedUser; + if ($resolvedUser === null) { + return $this->user; + } + + if ($this->user === null) { + return clone $resolvedUser; } $user = clone $this->user; diff --git a/tests/State/ScopeTest.php b/tests/State/ScopeTest.php index 8a5fb55d6..2a01c409e 100644 --- a/tests/State/ScopeTest.php +++ b/tests/State/ScopeTest.php @@ -362,6 +362,23 @@ public function testSetUserResolverDoesNotOverrideTheUser(): void ); } + public function testSetUserResolverDoesNotChangeTheResolvedUser(): void + { + $resolvedUser = UserDataBag::createFromUserIdentifier('unique_id'); + + $scope = new Scope(); + $scope->setUserResolver(static function () use ($resolvedUser): UserDataBag { + return $resolvedUser; + }); + + $event = Event::createEvent(); + $event->setUser(UserDataBag::createFromUserIpAddress('127.0.0.1')); + + $scope->applyToEvent($event); + + $this->assertEquals(UserDataBag::createFromUserIdentifier('unique_id'), $resolvedUser); + } + public function testSetUserResolverKeepsTheUserIfTheResolverThrows(): void { $scope = new Scope();