updates for Swoole 6.0.1

Signed-off-by: Demin Yin <deminy@deminy.net>

Author: deminy

src/swoole/Swoole/Coroutine/Lock.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Swoole\Coroutine;
+
+/**
+ * This Lock class provides a way to synchronize concurrent coroutines.
+ *
+ * @see \Swoole\Lock Use this instead when using locks accross processes.
+ * @since 6.0.1
+ */
+class Lock
+{
+ /**
+ * The error code of the last operation. It is set to 0 if the last operation was successful.
+ */
+ public int $errCode = 0;
+
+ /**
+ * @param bool $shared Use preserved shared memory of Swoole to create the lock or not.
+ */
+ public function __construct(bool $shared = false)
+ {
+ }
+
+ /**
+ * Lock the lock.
+ *
+ * If the lock is already acquired by another coroutine, this method will block until the lock is released.
+ *
+ * @return bool TRUE on success, FALSE on failure.
+ * @see Lock::trylock()
+ */
+ public function lock(): bool
+ {
+ }
+
+ /**
+ * Lock the lock in a non-blocking way.
+ *
+ * This method returns immediately even if the lock is not acquired. Thus, the caller should check the return value
+ * to see if the lock is acquired or not.
+ *
+ * @return bool TRUE on success, FALSE on failure.
+ * @see Lock::lock()
+ */
+ public function trylock(): bool
+ {
+ }
+
+ /**
+ * Unlock the lock.
+ *
+ * @return bool TRUE on success, FALSE on failure.
+ */
+ public function unlock(): bool
+ {
+ }
+}

src/swoole/Swoole/Lock.php

@@ -14,8 +14,9 @@
  * cause memory leaks since memory usage could keep increasing as new requests keep coming in. In general, it's not
  * recommended to keep creating/destroying locks since this could cause memory leaks.
  *
- * Locks should not be used in coroutines, especially when there are coroutine switching between method calls to
- * \Swoole\Lock::lock() and \Swoole\Lock::unlock(). For example, the following example will cause deadlock:
+ * This Lock class is not coroutine-friendly. It should not be used across different coroutines, especially when there
+ * are coroutine switching between method calls to \Swoole\Lock::lock() and \Swoole\Lock::unlock(). For example, the
+ * following example will cause deadlock:
  *
  * Swoole\Coroutine\run(function () {
  * $lock = new Swoole\Lock();
@@ -28,9 +29,12 @@
  * }
  * });
  *
- * If you think you need to use locks with coroutines, you can probably use channels instead.
+ * If you think you need to use locks with coroutines, there are two options:
+ * 1. use channels (before Swoole 6.0.1).
+ * 2. use class \Swoole\Coroutine\Lock (since Swoole 6.0.1).
  *
  * @see \Swoole\Thread\Lock Use this instead when PHP is compiled with Zend Thread Safety (ZTS) enabled.
+ * @see \Swoole\Coroutine\Lock Use this instead when using locks accross coroutines.
  * @see https://github.com/deminy/swoole-by-examples/blob/master/examples/csp/deadlocks/swoole-lock.php
  * @not-serializable Objects of this class cannot be serialized.
  */
@@ -159,13 +163,4 @@ public function trylock_read(): bool
  public function unlock(): bool
  {
  }
-
- /**
- * Destroy the lock and release any resources used by the lock.
- *
- * After calling this method, the lock object should not be used anymore.
- */
- public function destroy(): void
- {
- }
 }

src/swoole/Swoole/Thread/ArrayList.php

@@ -84,4 +84,13 @@ public function count(): int
  public function toArray(): array
  {
  }
+
+ /**
+ * Sort the list in ascending order, without maintaining index association.
+ *
+ * @since 6.0.1
+ */
+ public function sort(): void
+ {
+ }
 }

src/swoole/Swoole/Thread/Map.php

@@ -98,4 +98,13 @@ public function values(): array
  public function toArray(): array
  {
  }
+
+ /**
+ * Sort the map in ascending order.
+ *
+ * @since 6.0.1
+ */
+ public function sort(): void
+ {
+ }
 }

src/swoole/constants.php

@@ -5,11 +5,11 @@
 /*
  * Swoole version information.
  */
-define('SWOOLE_VERSION', '6.0.0');
-define('SWOOLE_VERSION_ID', 60000);
+define('SWOOLE_VERSION', '6.0.1');
+define('SWOOLE_VERSION_ID', 60001);
 define('SWOOLE_MAJOR_VERSION', 6);
 define('SWOOLE_MINOR_VERSION', 0);
-define('SWOOLE_RELEASE_VERSION', 0);
+define('SWOOLE_RELEASE_VERSION', 1);
 define('SWOOLE_EXTRA_VERSION', '');
 
 /*
@@ -304,7 +304,6 @@
 #ifdef HAVE_SPINLOCK
 define('SWOOLE_SPINLOCK', 5); # Supported only if the Spin Locks option is provided in the POSIX thread (pthread) libraries.
 #endif
-define('SWOOLE_COROLOCK', 6); # @since v6.0.0
 
 /*
  * Following SIG_* and PRIO_* constants are set only when PHP extension pcntl (to support Process Control) is not