Standardize nullable type hints to 'null|Type' order

Refactors type hints and docblocks across the codebase to consistently use the 'null|Type' order for nullable types, improving code readability and alignment with modern PHP standards. No functional changes are introduced; this is a documentation and type annotation update only.

Author: huangdijia

src/Annotation/BlockableAspect.php

@@ -30,7 +30,7 @@ public function process(ProceedingJoinPoint $proceedingJoinPoint)
     {
         $arguments = $proceedingJoinPoint->arguments['keys'] ?? [];
         $annotationMetadata = $proceedingJoinPoint->getAnnotationMetadata();
-        /** @var Blockable|null $annotation */
+        /** @var null|Blockable $annotation */
         $annotation = $annotationMetadata->method[Blockable::class] ?? null;
 
         if (! $annotation || $annotation->seconds <= 0) {

src/Driver/AbstractLock.php

@@ -124,7 +124,7 @@ public function betweenBlockedAttemptsSleepFor($milliseconds): self
     /**
      * Determine whether this lock is owned by the given identifier.
      *
-     * @param string|null $owner
+     * @param null|string $owner
      */
     public function isOwnedBy($owner): bool
     {

src/Driver/CoroutineLock.php

@@ -25,14 +25,14 @@ class CoroutineLock extends AbstractLock
     protected static array $channels = [];
 
     /**
-     * @var WeakMap<Channel, string>|null
+     * @var null|WeakMap<Channel, string>
      */
     protected static ?WeakMap $owners = null;
 
     protected static ?Timer $timer = null;
 
     /**
-     * @var WeakMap<Channel, int>|null
+     * @var null|WeakMap<Channel, int>
      */
     protected static ?WeakMap $timers = null;
 

src/Driver/LockInterface.php

@@ -18,7 +18,7 @@ interface LockInterface
     /**
      * Attempt to acquire the lock.
      * @template T
-     * @param (callable(): T)|null $callback
+     * @param null|(callable(): T) $callback
      * @return ($callback is null ? bool : T)
      */
     public function get(?callable $callback = null);
@@ -27,7 +27,7 @@ public function get(?callable $callback = null);
      * Attempt to acquire the lock for the given number of seconds.
      *
      * @template T
-     * @param (callable(): T)|null $callback
+     * @param null|(callable(): T) $callback
      * @return ($callback is null ? bool : T)
      * @throws LockTimeoutException
      */