feat(sentry): add SentrySdkAspect for coroutine-safe SDK usage

Add an aspect that intercepts SentrySdk::init, ::setCurrentHub, and
::getRuntimeContextManager to make them coroutine-safe using Hyperf's
Context API and RuntimeContextManager.

This ensures that Sentry SDK works correctly in a coroutine environment
by storing the runtime context manager in Hyperf's context storage.

Author: huangdijia

src/sentry/src/Aspect/SentrySdkAspect.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of friendsofhyperf/components.
+ *
+ * @link     https://github.com/friendsofhyperf/components
+ * @document https://github.com/friendsofhyperf/components/blob/main/README.md
+ * @contact  huangdijia@gmail.com
+ */
+
+namespace FriendsOfHyperf\Sentry\Aspect;
+
+use Closure;
+use Hyperf\Context\Context;
+use Hyperf\Di\Aop\AbstractAspect;
+use Hyperf\Di\Aop\ProceedingJoinPoint;
+use Sentry\SentrySdk;
+use Sentry\State\HubInterface;
+use Sentry\State\RuntimeContextManager;
+
+use function Hyperf\Support\make;
+
+class SentrySdkAspect extends AbstractAspect
+{
+    public array $classes = [
+        SentrySdk::class . '::init',
+        SentrySdk::class . '::setCurrentHub',
+        SentrySdk::class . '::getRuntimeContextManager',
+    ];
+
+    public function process(ProceedingJoinPoint $proceedingJoinPoint)
+    {
+        // Do nothing, just for class mapping.
+        return match ($proceedingJoinPoint->methodName) {
+            'init' => $this->handleInit($proceedingJoinPoint),
+            'setCurrentHub' => $this->handleSetCurrentHub($proceedingJoinPoint),
+            'getRuntimeContextManager' => $this->handleGetRuntimeContextManager($proceedingJoinPoint),
+            default => $proceedingJoinPoint->process(),
+        };
+    }
+
+    private function handleInit(ProceedingJoinPoint $proceedingJoinPoint)
+    {
+        Context::set(
+            RuntimeContextManager::class,
+            new RuntimeContextManager(make(HubInterface::class))
+        );
+
+        return SentrySdk::getCurrentHub();
+    }
+
+    private function handleSetCurrentHub(ProceedingJoinPoint $proceedingJoinPoint)
+    {
+        $arguments = $proceedingJoinPoint->arguments ?? [];
+        $hub = $arguments['hub'];
+        // @phpstan-ignore-next-line
+        Closure::bind(fn () => static::getRuntimeContextManager()->setCurrentHub($hub), null, SentrySdk::class)();
+
+        return $hub;
+    }
+
+    private function handleGetRuntimeContextManager(ProceedingJoinPoint $proceedingJoinPoint)
+    {
+        return Context::getOrSet(
+            RuntimeContextManager::class,
+            fn () => new RuntimeContextManager(make(HubInterface::class))
+        );
+    }
+}

src/sentry/src/ConfigProvider.php

@@ -28,6 +28,7 @@ public function __invoke(): array
                 Aspect\LoggerAspect::class,
                 Aspect\RedisAspect::class,
                 // Aspect\SingletonAspect::class,
+                Aspect\SentrySdkAspect::class,
                 Metrics\Aspect\CounterAspect::class,
                 Metrics\Aspect\HistogramAspect::class,
                 Tracing\Aspect\AmqpProducerAspect::class,