vendor/sentry/sentry/src/State/HubAdapter.php line 85

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace Sentry\State;
  7. use Sentry\Breadcrumb;
  8. use Sentry\ClientInterface;
  9. use Sentry\Event;
  10. use Sentry\EventHint;
  11. use Sentry\EventId;
  12. use Sentry\Integration\IntegrationInterface;
  13. use Sentry\SentrySdk;
  14. use Sentry\Severity;
  15. use Sentry\Tracing\Span;
  16. use Sentry\Tracing\Transaction;
  17. use Sentry\Tracing\TransactionContext;
  19. /**
  20.  * An implementation of {@see HubInterface} that uses {@see SentrySdk} internally
  21.  * to manage the current hub.
  22.  */
  23. final class HubAdapter implements HubInterface
  24. {
  25.     /**
  26.      * @var self|null The single instance which forwards all calls to {@see SentrySdk}
  27.      */
  28.     private static $instance;
  30.     /**
  31.      * Constructor.
  32.      */
  33.     private function __construct()
  34.     {
  35.     }
  37.     /**
  38.      * Gets the instance of this class. This is a singleton, so once initialized
  39.      * you will always get the same instance.
  40.      */
  41.     public static function getInstance(): self
  42.     {
  43.         if (null === self::$instance) {
  44.             self::$instance = new self();
  45.         }
  47.         return self::$instance;
  48.     }
  50.     /**
  51.      * {@inheritdoc}
  52.      */
  53.     public function getClient(): ?ClientInterface
  54.     {
  55.         return SentrySdk::getCurrentHub()->getClient();
  56.     }
  58.     /**
  59.      * {@inheritdoc}
  60.      */
  61.     public function getLastEventId(): ?EventId
  62.     {
  63.         return SentrySdk::getCurrentHub()->getLastEventId();
  64.     }
  66.     /**
  67.      * {@inheritdoc}
  68.      */
  69.     public function pushScope(): Scope
  70.     {
  71.         return SentrySdk::getCurrentHub()->pushScope();
  72.     }
  74.     /**
  75.      * {@inheritdoc}
  76.      */
  77.     public function popScope(): bool
  78.     {
  79.         return SentrySdk::getCurrentHub()->popScope();
  80.     }
  82.     /**
  83.      * {@inheritdoc}
  84.      */
  85.     public function withScope(callable $callback)
  86.     {
  87.         return SentrySdk::getCurrentHub()->withScope($callback);
  88.     }
  90.     /**
  91.      * {@inheritdoc}
  92.      */
  93.     public function configureScope(callable $callback): void
  94.     {
  95.         SentrySdk::getCurrentHub()->configureScope($callback);
  96.     }
  98.     /**
  99.      * {@inheritdoc}
  100.      */
  101.     public function bindClient(ClientInterface $client): void
  102.     {
  103.         SentrySdk::getCurrentHub()->bindClient($client);
  104.     }
  106.     /**
  107.      * {@inheritdoc}
  108.      */
  109.     public function captureMessage(string $message, ?Severity $level = null, ?EventHint $hint = null): ?EventId
  110.     {
  111.         return SentrySdk::getCurrentHub()->captureMessage($message, $level, $hint);
  112.     }
  114.     /**
  115.      * {@inheritdoc}
  116.      */
  117.     public function captureException(\Throwable $exception, ?EventHint $hint = null): ?EventId
  118.     {
  119.         return SentrySdk::getCurrentHub()->captureException($exception, $hint);
  120.     }
  122.     /**
  123.      * {@inheritdoc}
  124.      */
  125.     public function captureEvent(Event $event, ?EventHint $hint = null): ?EventId
  126.     {
  127.         return SentrySdk::getCurrentHub()->captureEvent($event, $hint);
  128.     }
  130.     /**
  131.      * {@inheritdoc}
  132.      */
  133.     public function captureLastError(?EventHint $hint = null): ?EventId
  134.     {
  135.         return SentrySdk::getCurrentHub()->captureLastError($hint);
  136.     }
  138.     /**
  139.      * {@inheritdoc}
  140.      */
  141.     public function addBreadcrumb(Breadcrumb $breadcrumb): bool
  142.     {
  143.         return SentrySdk::getCurrentHub()->addBreadcrumb($breadcrumb);
  144.     }
  146.     /**
  147.      * {@inheritdoc}
  148.      */
  149.     public function getIntegration(string $className): ?IntegrationInterface
  150.     {
  151.         return SentrySdk::getCurrentHub()->getIntegration($className);
  152.     }
  154.     /**
  155.      * {@inheritdoc}
  156.      *
  157.      * @param array<string, mixed> $customSamplingContext Additional context that will be passed to the {@see SamplingContext}
  158.      */
  159.     public function startTransaction(TransactionContext $context, array $customSamplingContext = []): Transaction
  160.     {
  161.         return SentrySdk::getCurrentHub()->startTransaction($context, $customSamplingContext);
  162.     }
  164.     /**
  165.      * {@inheritdoc}
  166.      */
  167.     public function getTransaction(): ?Transaction
  168.     {
  169.         return SentrySdk::getCurrentHub()->getTransaction();
  170.     }
  172.     /**
  173.      * {@inheritdoc}
  174.      */
  175.     public function getSpan(): ?Span
  176.     {
  177.         return SentrySdk::getCurrentHub()->getSpan();
  178.     }
  180.     /**
  181.      * {@inheritdoc}
  182.      */
  183.     public function setSpan(?Span $span): HubInterface
  184.     {
  185.         return SentrySdk::getCurrentHub()->setSpan($span);
  186.     }
  188.     /**
  189.      * @see https://www.php.net/manual/en/language.oop5.cloning.php#object.clone
  190.      */
  191.     public function __clone()
  192.     {
  193.         throw new \BadMethodCallException('Cloning is forbidden.');
  194.     }
  196.     /**
  197.      * @see https://www.php.net/manual/en/language.oop5.magic.php#object.wakeup
  198.      */
  199.     public function __wakeup()
  200.     {
  201.         throw new \BadMethodCallException('Unserializing instances of this class is forbidden.');
  202.     }
  203. }