Add new options

Author: cleptric

src/Options.php

@@ -194,10 +194,7 @@ public function setTracesSampleRate(?float $sampleRate): self
 
     public function getProfilesSampleRate(): ?float
     {
-        /** @var int|float|null $value */
-        $value = $this->options['profiles_sample_rate'] ?? null;
-
-        return $value ?? null;
+        return $this->options['profiles_sample_rate'];
     }
 
     public function setProfilesSampleRate(?float $sampleRate): self
@@ -209,6 +206,34 @@ public function setProfilesSampleRate(?float $sampleRate): self
         return $this;
     }
 
+    public function getProfileSessionSampleRate(): ?float
+    {
+        return $this->options['profile_session_sample_rate'];
+    }
+
+    public function setProfileSessionSampleRate(?float $sampleRate): self
+    {
+        $options = array_merge($this->options, ['profile_session_sample_rate' => $sampleRate]);
+
+        $this->options = $this->resolver->resolve($options);
+
+        return $this;
+    }
+
+    public function getProfileLifecycle(): ?string
+    {
+        return $this->options['profile_lifecycle'] ?? null;
+    }
+
+    public function setProfileLifecycle(?string $lifecycle): self
+    {
+        $options = array_merge($this->options, ['profile_lifecycle' => $lifecycle]);
+
+        $this->options = $this->resolver->resolve($options);
+
+        return $this;
+    }
+
     /**
      * Gets whether tracing is enabled or not. The feature is enabled when at
      * least one of the `traces_sample_rate` and `traces_sampler` options is
@@ -1223,6 +1248,8 @@ private function configureOptions(OptionsResolver $resolver): void
             'traces_sample_rate' => null,
             'traces_sampler' => null,
             'profiles_sample_rate' => null,
+            'profile_session_sample_rate' => null,
+            'profile_lifecycle' => null,
             'attach_stacktrace' => false,
             /**
              * @deprecated Metrics are no longer supported. Metrics API is a no-op and will be removed in 5.x.
@@ -1293,6 +1320,8 @@ private function configureOptions(OptionsResolver $resolver): void
         $resolver->setAllowedTypes('traces_sample_rate', ['null', 'int', 'float']);
         $resolver->setAllowedTypes('traces_sampler', ['null', 'callable']);
         $resolver->setAllowedTypes('profiles_sample_rate', ['null', 'int', 'float']);
+        $resolver->setAllowedTypes('profile_session_sample_rate', ['null', 'int', 'float']);
+        $resolver->setAllowedTypes('profile_lifecycle', ['null', 'string']);
         $resolver->setAllowedTypes('attach_stacktrace', 'bool');
         $resolver->setAllowedTypes('attach_metric_code_locations', 'bool');
         $resolver->setAllowedTypes('context_lines', ['null', 'int']);
@@ -1335,6 +1364,7 @@ private function configureOptions(OptionsResolver $resolver): void
         $resolver->setAllowedTypes('class_serializers', 'array');
 
         $resolver->setAllowedValues('max_request_body_size', ['none', 'never', 'small', 'medium', 'always']);
+        $resolver->setAllowedValues('profile_lifecycle', [null, 'trace', 'manual']);
         $resolver->setAllowedValues('dsn', \Closure::fromCallable([$this, 'validateDsnOption']));
         $resolver->setAllowedValues('max_breadcrumbs', \Closure::fromCallable([$this, 'validateMaxBreadcrumbsOptions']));
         $resolver->setAllowedValues('class_serializers', \Closure::fromCallable([$this, 'validateClassSerializersOption']));

tests/OptionsTest.php

@@ -138,6 +138,27 @@ static function (): void {},
             'setProfilesSampleRate',
         ];
 
+        yield [
+            'profile_lifecycle',
+            'trace',
+            'getProfileLifecycle',
+            'setProfileLifecycle',
+        ];
+
+        yield [
+            'profile_lifecycle',
+            'manual',
+            'getProfileLifecycle',
+            'setProfileLifecycle',
+        ];
+
+        yield [
+            'profile_lifecycle',
+            null,
+            'getProfileLifecycle',
+            'setProfileLifecycle',
+        ];
+
         yield [
             'attach_stacktrace',
             false,
@@ -630,6 +651,64 @@ public static function contextLinesOptionValidatesInputValueDataProvider(): \Gen
         ];
     }
 
+    /**
+     * @dataProvider profileLifecycleOptionValidatesInputValueDataProvider
+     */
+    public function testProfileLifecycleOptionValidatesInputValue($value, ?string $expectedExceptionMessage): void
+    {
+        if ($expectedExceptionMessage !== null) {
+            $this->expectException(InvalidOptionsException::class);
+            $this->expectExceptionMessage($expectedExceptionMessage);
+        } else {
+            $this->expectNotToPerformAssertions();
+        }
+
+        new Options(['profile_lifecycle' => $value]);
+    }
+
+    public static function profileLifecycleOptionValidatesInputValueDataProvider(): \Generator
+    {
+        yield [
+            'trace',
+            null,
+        ];
+
+        yield [
+            'manual',
+            null,
+        ];
+
+        yield [
+            null,
+            null,
+        ];
+
+        yield [
+            'invalid',
+            'The option "profile_lifecycle" with value "invalid" is invalid.',
+        ];
+
+        yield [
+            'auto',
+            'The option "profile_lifecycle" with value "auto" is invalid.',
+        ];
+
+        yield [
+            '',
+            'The option "profile_lifecycle" with value "" is invalid.',
+        ];
+
+        yield [
+            123,
+            'The option "profile_lifecycle" with value 123 is expected to be of type "null" or "string", but is of type "int".',
+        ];
+
+        yield [
+            true,
+            'The option "profile_lifecycle" with value true is expected to be of type "null" or "string", but is of type "bool".',
+        ];
+    }
+
     /**
      * @backupGlobals enabled
      */