eee

Abstracts/AsyncServer.php

@@ -92,7 +92,7 @@ class AsyncServer extends Component implements ServerInterface
             $config->events[Constant::SHUTDOWN] = [OnServer::class, 'onShutdown'];
         }
 
-        $this->event($this->server, array_merge(\config('server.events', []), $config->events));
+        $this->event($this->server, array_merge(\config('servers.server.events', []), $config->events));
         $this->container->bind(ServerInterface::class, $this->server);
         return $service;
     }
@@ -106,7 +106,7 @@ class AsyncServer extends Component implements ServerInterface
      */
     protected function systemConfig(SConfig $config, int $daemon): array
     {
-        $settings                                     = array_merge(\config('server.settings', []), $config->settings);
+        $settings                                     = array_merge(\config('servers.server.settings', []), $config->settings);
         $settings[Constant::OPTION_DAEMONIZE]         = (bool)$daemon;
         $settings[Constant::OPTION_ENABLE_REUSE_PORT] = true;
         $settings[Constant::OPTION_PID_FILE]          = storage('.swoole.pid');

Abstracts/HotReload.php

@@ -0,0 +1,171 @@
+<?php
+
+namespace Kiri\Server\Abstracts;
+
+use Kiri\Di\Inject\Container;
+use Kiri\Error\StdoutLogger;
+use Kiri\Events\EventProvider;
+use Kiri\Router\Router;
+use Kiri\Server\Events\OnWorkerStart;
+use Kiri\Server\ServerInterface;
+use Psr\Log\LoggerInterface;
+use Swoole\Event;
+use Swoole\Process;
+use Kiri\Server\Processes\AbstractProcess;
+
+class HotReload extends AbstractProcess
+{
+
+
+    /**
+     * @var mixed
+     */
+    protected mixed $pipe;
+
+
+    /**
+     * @var LoggerInterface|StdoutLogger
+     */
+    #[Container(LoggerInterface::class)]
+    public StdoutLogger|LoggerInterface $logger;
+
+
+    /**
+     * @var bool
+     */
+    protected bool $enable_coroutine = false;
+
+
+    /**
+     * @var array
+     */
+    protected array $watches = [];
+
+
+    /**
+     * @var bool
+     */
+    protected bool $enable_queue = false;
+
+
+    /**
+     * @var bool
+     */
+    protected bool $reloading = false;
+
+
+    /**
+     * @throws \Exception
+     */
+    public function __construct()
+    {
+        di(EventProvider::class)->on(OnWorkerStart::class, [di(Router::class), 'scan_build_route']);
+    }
+
+
+    /**
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'hotReload';
+    }
+
+
+    /**
+     * @return void
+     */
+    public function onSigterm(): void
+    {
+        // TODO: Implement onSigterm() method.
+        $this->stop();
+    }
+
+    /**
+     * @param ?Process $process
+     */
+    public function process(Process|null $process): void
+    {
+        $this->pipe = inotify_init();
+        $this->addListen();
+        Event::add($this->pipe, function () use ($process) {
+            $read = inotify_read($this->pipe);
+            if (count($read) > 0) {
+                $this->reload();
+            }
+        });
+        Event::cycle(function (): void {
+            if ($this->isStop()) {
+                Event::exit();
+            }
+        });
+        Event::wait();
+    }
+
+
+    /**
+     * @return void
+     */
+    public function reload(): void
+    {
+        if ($this->reloading) {
+            return;
+        }
+        $this->reloading = true;
+
+        di(StdoutLogger::class)->println('reloading server[' . \config('site.id', 'system-service') . '], please waite.');
+
+        $this->clear();
+        di(ServerInterface::class)->reload();
+        $this->addListen();
+
+        $this->reloading = false;
+    }
+
+
+    /**
+     * @return void
+     */
+    protected function addListen(): void
+    {
+        foreach (config('servers.reload.listen') as $value) {
+            $this->readDirectory($value);
+        }
+    }
+
+
+    /**
+     * @return void
+     */
+    protected function clear(): void
+    {
+        $this->watches = [];
+    }
+
+    /**
+     * @param string $directory
+     * @return void
+     */
+    public function readFile(string $directory): void
+    {
+        if (str_ends_with($directory, '.php') === true) {
+            inotify_add_watch($this->pipe, $directory, IN_MODIFY | IN_MOVE | IN_CREATE | IN_DELETE);
+        }
+    }
+
+
+    /**
+     * @param string $directory
+     * @return void
+     */
+    public function readDirectory(string $directory): void
+    {
+        foreach (glob($directory . '/*') as $data) {
+            if (is_dir($data)) {
+                $this->readDirectory($data);
+            } else {
+                $this->readFile($data);
+            }
+        }
+    }
+}

Abstracts/Server.php

@@ -4,6 +4,8 @@
 namespace Kiri\Server\Abstracts;
 
 
+use Kiri\Error\StdoutLogger;
+
 /**
  * Class Server
  * @package Server\Abstracts
@@ -11,12 +13,22 @@ namespace Kiri\Server\Abstracts;
 abstract class Server
 {
 
-    /**
+	/**
-     * Server constructor.
+	 * Server constructor.
-     * @throws
+	 * @throws
-     */
+	 */
-    public function __construct()
+	public function __construct()
-    {
+	{
-    }
+	}
+
+
+
+	/**
+	 * @return StdoutLogger
+	 */
+	protected function getLogger(): StdoutLogger
+	{
+		return \Kiri::getLogger();
+	}
 
 }

Abstracts/TraitServer.php

@@ -21,7 +21,7 @@ trait TraitServer
      */
     public function onSignal(): void
     {
-        $signal = \config('signal', []);
+        $signal = \config('servers.signal', []);
         $this->onPcntlSignal(SIGINT, [$this, 'onSigint']);
         foreach ($signal as $sig => $value) {
             if (is_array($value) && is_string($value[0])) {
@@ -46,7 +46,7 @@ trait TraitServer
             Kiri::getLogger()->alert('Pid ' . getmypid() . ' get signo ' . $no);
             $this->shutdown();
         } catch (\Throwable $exception) {
-            error($exception);
+			\Kiri::getLogger()->json_log($exception);
         }
     }
 

Handler/OnPipeMessage.php

@@ -2,6 +2,7 @@
 
 namespace Kiri\Server\Handler;
 
+use Kiri;
 use Kiri\Server\Abstracts\Server;
 use Kiri\Server\Contract\OnPipeMessageInterface;
 
@@ -20,13 +21,17 @@ class OnPipeMessage extends Server
      */
     public function onPipeMessage(\Swoole\Server $server, int $src_worker_id, mixed $message): void
     {
-        if (is_string($message)) {
+        try {
-            $message = unserialize($message);
+            if (is_string($message)) {
+                $message = unserialize($message);
+            }
+            if (!is_object($message) || !($message instanceof OnPipeMessageInterface)) {
+                return;
+            }
+            call_user_func([$message, 'process'], $server, $src_worker_id);
+        } catch (\Throwable $throwable) {
+			\Kiri::getLogger()->json_log($throwable, ['src_worker_id' => $src_worker_id, 'message' => $message]);
         }
-        if (!is_object($message) || !($message instanceof OnPipeMessageInterface)) {
-            return;
-        }
-        call_user_func([$message, 'process'], $server, $src_worker_id);
     }
 
 

Handler/OnServerWorker.php

@@ -3,7 +3,10 @@
 namespace Kiri\Server\Handler;
 
 use Kiri;
+use Kiri\Abstracts\CoordinatorManager;
+use Kiri\Coordinator;
 use Kiri\Core\Help;
+use Kiri\Di\Inject\Container;
 use Kiri\Events\EventDispatch;
 use Kiri\Server\Events\OnAfterWorkerStart;
 use Kiri\Server\Events\OnBeforeWorkerStart;
@@ -12,6 +15,7 @@ use Kiri\Server\Events\OnWorkerError;
 use Kiri\Server\Events\OnWorkerExit;
 use Kiri\Server\Events\OnWorkerStart;
 use Kiri\Server\Events\OnWorkerStop;
+use Psr\Http\Message\RequestInterface;
 use Swoole\Server;
 use Swoole\Timer;
 use Throwable;
@@ -25,120 +29,140 @@ use function config;
 class OnServerWorker extends Kiri\Server\Abstracts\Server
 {
 
-    /**
+
-     * @return void
+	/**
-     */
+	 * @var EventDispatch
-    public function init(): void
+	 */
-    {
+	#[Container(EventDispatch::class)]
-        on(OnBeforeWorkerStart::class, [$this, 'onWorkerNameAlias']);
+	public EventDispatch $dispatch;
-    }
 
 
-    /**
+	/**
-     * @param OnBeforeWorkerStart $workerStart
+	 * @return void
-     * @return void
+	 */
-     */
+	public function init(): void
-    public function onWorkerNameAlias(OnBeforeWorkerStart $workerStart): void
+	{
-    {
+		on(OnBeforeWorkerStart::class, [$this, 'onWorkerNameAlias']);
-        set_env('environmental_workerId', $workerStart->workerId);
+	}
-        if ($workerStart->workerId < $workerStart->server->setting['worker_num']) {
-            $this->processName($workerStart->server, 'Worker');
-            set_env('environmental', Kiri::WORKER);
-        } else {
-            $this->processName($workerStart->server, 'Tasker');
-            set_env('environmental', Kiri::TASK);
-        }
-    }
 
 
-    /**
+	/**
-     * @param Server $server
+	 * @param OnBeforeWorkerStart $workerStart
-     * @param int $workerId
+	 * @return void
-     * @return void
+	 */
-     * @throws
+	public function onWorkerNameAlias(OnBeforeWorkerStart $workerStart): void
-     */
+	{
-    public function onWorkerStart(Server $server, int $workerId): void
+		if ($workerStart->workerId < $workerStart->server->setting['worker_num']) {
-    {
+			$this->processName($workerStart->server, 'Worker');
-        $dispatch = Kiri::getDi()->get(EventDispatch::class);
+			set_env('environmental', Kiri::WORKER);
-        $dispatch->dispatch(new OnBeforeWorkerStart($server, $workerId));
+		} else {
-        if ($workerId < $server->setting['worker_num']) {
+			$this->processName($workerStart->server, 'Tasker');
-            $dispatch->dispatch(new OnWorkerStart($server, $workerId));
+			set_env('environmental', Kiri::TASK);
-        } else {
+		}
-            $dispatch->dispatch(new OnTaskerStart($server, $workerId));
+		set_env('environmental_worker_id', $workerStart->workerId);
-        }
+	}
-        $dispatch->dispatch(new OnAfterWorkerStart($server, $workerId));
-    }
 
 
-    /**
+	/**
-     * @param Server $server
+	 * @param Server $server
-     * @param string $prefix
+	 * @param int $workerId
-     * @return void
+	 * @return void
-     */
+	 * @throws
-    protected function processName(Server $server, string $prefix): void
+	 */
-    {
+	public function onWorkerStart(Server $server, int $workerId): void
-        Kiri::setProcessName(sprintf($prefix . '[%d]', $server->worker_pid));
+	{
-    }
+		try {
+			$this->dispatch->dispatch(new OnBeforeWorkerStart($server, $workerId));
+			if ($workerId < $server->setting['worker_num']) {
+				CoordinatorManager::utility(Coordinator::WORKER_START)->waite();
+
+				$this->dispatch->dispatch(new OnWorkerStart($server, $workerId));
+			} else {
+				$this->dispatch->dispatch(new OnTaskerStart($server, $workerId));
+			}
+		} catch (Throwable $exception) {
+			\Kiri::getLogger()->json_log($exception);
+		} finally {
+			$this->dispatch->dispatch(new OnAfterWorkerStart($server, $workerId));
+		}
+	}
 
 
-    /**
+	/**
-     * @param Server $server
+	 * @param Server $server
-     * @param int $workerId
+	 * @param string $prefix
-     * @throws
+	 * @return void
-     */
+	 */
-    public function onWorkerStop(Server $server, int $workerId): void
+	protected function processName(Server $server, string $prefix): void
-    {
+	{
-        event(new OnWorkerStop($server, $workerId));
+		Kiri::setProcessName(sprintf($prefix . '[%d]', $server->worker_pid));
-        Timer::clearAll();
+	}
-    }
 
 
-    /**
+	/**
-     * @param Server $server
+	 * @param Server $server
-     * @param int $workerId
+	 * @param int $workerId
-     * @throws
+	 * @throws
-     */
+	 */
-    public function onWorkerExit(Server $server, int $workerId): void
+	public function onWorkerStop(Server $server, int $workerId): void
-    {
+	{
-        event(new OnWorkerExit($server, $workerId));
+		event(new OnWorkerStop($server, $workerId));
-    }
+		Timer::clearAll();
+	}
 
 
-    /**
+	/**
-     * @param Server $server
+	 * @param Server $server
-     * @param int $worker_id
+	 * @param int $workerId
-     * @param int $worker_pid
+	 * @throws
-     * @param int $exit_code
+	 */
-     * @param int $signal
+	public function onWorkerExit(Server $server, int $workerId): void
-     * @throws
+	{
-     */
+		event(new OnWorkerExit($server, $workerId));
-    public function onWorkerError(Server $server, int $worker_id, int $worker_pid, int $exit_code, int $signal): void
+	}
-    {
-        event(new OnWorkerError($server, $worker_id, $worker_pid, $exit_code, $signal));
-
-        debug_print_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);
-        $message = sprintf('Worker#%d::%d error stop. signal %d, exit_code %d, msg %s', $worker_id, $worker_pid, $signal, $exit_code, swoole_strerror(swoole_last_error(), $signal));
-
-        error($message);
-
-        $this->system_mail($message);
-    }
 
 
-    /**
+	/**
-     * @param $messageContent
+	 * @param Server $server
-     * @throws
+	 * @param int $worker_id
-     */
+	 * @param int $worker_pid
-    protected function system_mail($messageContent): void
+	 * @param int $exit_code
-    {
+	 * @param int $signal
-        try {
+	 * @throws
-            $email = config('email', ['enable' => false]);
+	 */
-            if (!empty($email) && ($email['enable'] ?? false)) {
+	public function onWorkerError(Server $server, int $worker_id, int $worker_pid, int $exit_code, int $signal): void
-                Help::sendEmail($email, 'Service Error', $messageContent);
+	{
-            }
+		event(new OnWorkerError($server, $worker_id, $worker_pid, $exit_code, $signal));
-        } catch (Throwable $e) {
+
-            error($e, ['email']);
+		debug_print_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);
-        }
+
-    }
+		/** @var RequestInterface $context */
+		$context = Kiri\Di\Context::get(RequestInterface::class);
+		if (is_null($context)) {
+			$message = sprintf('Worker#%d::%d error stop. signal %d, exit_code %d, msg %s', $worker_id, $worker_pid, $signal, $exit_code, swoole_strerror(swoole_last_error(), $signal));
+		} else {
+			$message = sprintf('Worker#%d::%d error stop. signal %d, exit_code %d, msg %s, method: %s, path: %s, query: %s', $worker_id, $worker_pid, $signal, $exit_code, swoole_strerror(swoole_last_error(), $signal),
+							   $context->getMethod(), $context->getUri()->getPath(), $context->getUri()->getQuery());
+		}
+		$this->getLogger()->println($message);
+		$this->system_mail($message);
+	}
+
+
+	/**
+	 * @param $messageContent
+	 * @throws
+	 */
+	protected function system_mail($messageContent): void
+	{
+		try {
+			$email = config('email', ['enable' => false]);
+			if (!empty($email) && ($email['enable'] ?? false)) {
+				Help::sendEmail($email, 'Service Error', $messageContent);
+			}
+		} catch (Throwable $e) {
+			\Kiri::getLogger()->json_log($e);
+		}
+	}
 
 }

Processes/AbstractProcess.php

@@ -5,6 +5,8 @@ namespace Kiri\Server\Processes;
 
 use Swoole\Coroutine;
 use Swoole\Process;
+use const SIGHUP;
+use const SIGTERM;
 
 /**
  *
@@ -125,26 +127,29 @@ abstract class AbstractProcess implements OnProcessInterface
     {
         $this->process = $process;
         if ($this->enable_coroutine) {
-            Coroutine::set([
+            $array['enable_deadlock_check']        = false;
-                'enable_deadlock_check'        => false,
+            $array['deadlock_check_disable_trace'] = false;
-                'deadlock_check_disable_trace' => false,
+            $array['exit_condition']               = [$this, 'exit_condition'];
-                'exit_condition'               => function () {
+            Coroutine::set($array);
-                    return Coroutine::stats()['coroutine_num'] === 0;
+            Coroutine::create(fn() => $this->coroutineWaitSignal());
-                }
-            ]);
-            Coroutine::create(fn () => $this->coroutineWaitSignal());
         } else {
-            pcntl_signal(SIGTERM, [$this, 'pointWaitSignal']);
+            $process::signal(SIGTERM | SIGINT | SIGUSR1, [$this, 'pointWaitSignal']);
         }
         return $this;
     }
 
 
+    public function exit_condition(): bool
+    {
+        return Coroutine::stats()['coroutine_num'] === 0;
+    }
+
+
     /**
-     * @param $data
+     * @param $signal
      * @return void
      */
-    public function pointWaitSignal($data): void
+    public function pointWaitSignal($signal): void
     {
         $this->stop = true;
 

Processes/TraitProcess.php

@@ -40,7 +40,7 @@ trait TraitProcess
     private function genProcess(AbstractProcess $name): Process
     {
         return new Process(function (Process $process) use ($name) {
-            $process->name('[' . \config('id', 'system-service') . '].' . $name->getName() . '[' . $process->pid . ']');
+            $process->name('[' . \config('site.id', 'system-service') . '].' . $name->getName() . '[' . $process->pid . ']');
             $name->onShutdown($process)->process($process);
         },
             $name->getRedirectStdinAndStdout(),

ServerCommand.php

@@ -6,16 +6,21 @@ namespace Kiri\Server;
 
 use Exception;
 use Kiri;
+use Kiri\Server\Events\OnWorkerStart;
+use Kiri\Events\EventProvider;
 use Kiri\Events\EventDispatch;
 use Kiri\Router\Router;
 use Kiri\Server\Abstracts\AsyncServer;
 use Kiri\Server\Events\OnShutdown;
+use Psr\Container\ContainerInterface;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use function config;
+use Kiri\Server\Abstracts\HotReload;
+use Kiri\Di\Inject\Container;
 
 defined('ROUTER_TYPE_HTTP') or define('ROUTER_TYPE_HTTP', 'http');
 defined('PID_PATH') or define('PID_PATH', APP_PATH . 'storage/server.pid');
@@ -28,18 +33,36 @@ class ServerCommand extends Command
 {
 
 
+    #[Container(State::class)]
     public State $state;
 
 
     /**
-     * @param string|null $name
+     * @var ContainerInterface
-     * @throws Exception
      */
-    public function __construct(string $name = null)
+    #[Container(ContainerInterface::class)]
-    {
+    public ContainerInterface $container;
-        parent::__construct($name);
+
-        $this->state = Kiri::getDi()->get(State::class);
+
-    }
+    /**
+     * @var AsyncServer
+     */
+    #[Container(AsyncServer::class)]
+    public AsyncServer $asyncServer;
+
+
+    /**
+     * @var EventDispatch
+     */
+    #[Container(EventDispatch::class)]
+    public EventDispatch $eventDispatch;
+
+
+    /**
+     * @var EventProvider
+     */
+    #[Container(EventProvider::class)]
+    public EventProvider $eventProvider;
 
 
     /**
@@ -91,13 +114,12 @@ class ServerCommand extends Command
      */
     protected function stop(): int
     {
-        $configs   = config('server', []);
+        $configs   = config('servers.server', []);
-        $instances = Kiri::getDi()->get(AsyncServer::class)->sortService($configs['ports'] ?? []);
+        $instances = $this->asyncServer->sortService($configs['ports'] ?? []);
         foreach ($instances as $config) {
             $this->state->exit($config->port);
         }
-        $dispatch = Kiri::getDi()->get(EventDispatch::class);
+        $this->eventDispatch->dispatch(new OnShutdown());
-        $dispatch->dispatch(new OnShutdown());
         return 1;
     }
 
@@ -109,12 +131,14 @@ class ServerCommand extends Command
      */
     protected function start(InputInterface $input): int
     {
-        $manager = Kiri::getDi()->get(AsyncServer::class);
+        $this->asyncServer->addProcess(config('process', []));
-        $router  = Kiri::getDi()->get(Router::class);
+        if (\config('servers.reload.hot', false) === true) {
-        $router->scan_build_route();
+            $this->asyncServer->addProcess([HotReload::class]);
-        $manager->addProcess(config('processes', []));
+        } else {
-        $manager->initCoreServers(config('server', []), (int)$input->getOption('daemon'));
+            di(Router::class)->scan_build_route();
-        $manager->start();
+        }
+        $this->asyncServer->initCoreServers(config('servers.server', []), (int)$input->getOption('daemon'));
+        $this->asyncServer->start();
         return 1;
     }
 

ServerProviders.php

@@ -23,6 +23,6 @@ class ServerProviders extends Providers
         $server = $this->container->get(ServerCommand::class);
 
         $console = $this->container->get(Application::class);
-        $console->add($server);
+        $console->addCommand($server);
     }
 }

State.php

@@ -21,7 +21,7 @@ class State extends Component
      */
     public function init(): void
     {
-        $this->servers = config('server.ports');
+        $this->servers = config('servers.server.ports');
     }
 
 

Task/OnTaskFinish.php

@@ -6,12 +6,12 @@ class OnTaskFinish
 {
 
 
-	/**
+    /**
-	 * @param int $task_id
+     * @param int $task_id
-	 * @param mixed $data
+     * @param mixed $data
-	 */
+     */
-	public function __construct(int $task_id, mixed $data)
+    public function __construct(public int $task_id, public mixed $data)
-	{
+    {
-	}
+    }
 
 }

Task/OnTaskInterface.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Kiri\Server\Task;
+
+interface OnTaskInterface
+{
+
+
+    /**
+     * @param int $task_id
+     * @param int $src_worker_id
+     * @return mixed
+     */
+    public function process(int $task_id, int $src_worker_id): mixed;
+
+
+}

Task/Task.php

@@ -24,7 +24,7 @@ class Task
      */
     public function __construct()
     {
-        $exception = \config('exception.task');
+        $exception = \config('servers.task.exception');
         if (!in_array(ExceptionHandlerInterface::class, class_implements($exception))) {
             $exception = ExceptionHandlerDispatcher::class;
         }
@@ -67,20 +67,26 @@ class Task
      * @param int $task_id
      * @param int $src_worker_id
      * @param mixed $data
-     * @return mixed
+     * @return void
      * @throws
      */
-    public function onTask(Server $server, int $task_id, int $src_worker_id, mixed $data): mixed
+    public function onTask(Server $server, int $task_id, int $src_worker_id, mixed $data): void
     {
         try {
-            $data = json_decode($data, true);
+            [$handler, $params] = [$data[0], $data[1]];
-            if (is_null($data)) {
+
-                return null;
+            $handler = Kiri::getDi()->make($handler, $params);
+            if (!($handler instanceof OnTaskInterface)) {
+                throw new \Exception('Task process must implements ' . OnTaskInterface::class);
             }
-            $data[0] = Kiri::getDi()->get($data[0]);
+
-            return call_user_func($data, $task_id, $src_worker_id);
+            $response = call_user_func([$handler, 'process'], $task_id, $src_worker_id);
         } catch (\Throwable $throwable) {
-            return $this->exception->emit($throwable, response());
+			\Kiri::getLogger()->json_log($throwable, ['task_id' => $task_id, 'src_worker_id' => $src_worker_id, 'data' => $data]);
+
+			$response = throwable($throwable);
+        } finally {
+            $server->finish($response);
         }
     }
 

Task/TaskExecute.php

@@ -2,22 +2,50 @@
 
 namespace Kiri\Server\Task;
 
+use Exception;
 use Kiri\Server\ServerInterface;
 
 class TaskExecute implements TaskInterface
 {
 
+
     /**
+     * @param string $handler
+     * @param mixed $data
+     * @param int $dstWorkerId
+     * @param callable|null $finishFinishCallback
+     * @return void
+     * @throws
+     */
+    public function task(string $handler, mixed $data, int $dstWorkerId = -1, ?callable $finishFinishCallback = null): void
+    {
+        $array = class_implements($handler, true);
+        if (!in_array(OnTaskInterface::class, $array, true)) {
+            throw new Exception('Task is not implement OnTaskInterface');
+        }
+        $server = \Kiri::getDi()->get(ServerInterface::class);
+
+        $server->task([$handler, $data], $dstWorkerId, $finishFinishCallback);
+    }
+
+
+    /**
+     * @param string $handler
      * @param mixed $data
      * @param float $timeout
      * @param int $dstWorkerId
      * @return mixed
+     * @throws
      */
-    public function taskWait(mixed $data, float $timeout = 0.5, int $dstWorkerId = -1): mixed
+    public function taskWait(string $handler, mixed $data, float $timeout = 0.5, int $dstWorkerId = -1): mixed
     {
+        $array = class_implements($handler, true);
+        if (!in_array(OnTaskInterface::class, $array, true)) {
+            throw new Exception('Task is not implement OnTaskInterface');
+        }
         $server = \Kiri::getDi()->get(ServerInterface::class);
 
-        return $server->taskwait($data, $timeout, $dstWorkerId);
+        return $server->taskwait([$handler, $data], $timeout, $dstWorkerId);
     }
 
 
@@ -45,6 +73,4 @@ class TaskExecute implements TaskInterface
 
         return $server->taskWaitMulti($tasks, $timeout);
     }
-
-
 }

Task/TaskInterface.php

@@ -7,11 +7,24 @@ interface TaskInterface
 
 
     /**
-     * @param array $tasks
+     * @param string $handler
-     * @param float $timeout
+     * @param mixed $data
-     * @return false|array
+     * @param int $dstWorkerId
+     * @param callable|null $finishFinishCallback
+     * @return void
      */
-    public function taskWaitMulti(array $tasks, float $timeout = 0.5): false|array;
+    public function task(string $handler, mixed $data, int $dstWorkerId = -1, ?callable $finishFinishCallback = null): void;
+
+
+    /**
+     * @param string $handler
+     * @param mixed $data
+     * @param float $timeout
+     * @param int $dstWorkerId
+     * @return mixed
+     */
+    public function taskWait(string $handler, mixed $data, float $timeout = 0.5, int $dstWorkerId = -1): mixed;
+
 
     /**
      * @param array $tasks
@@ -20,12 +33,12 @@ interface TaskInterface
      */
     public function taskCo(array $tasks, float $timeout = 0.5): false|array;
 
+
     /**
-     * @param mixed $data
+     * @param array $tasks
      * @param float $timeout
-     * @param int $dstWorkerId
+     * @return false|array
-     * @return mixed
      */
-    public function taskWait(mixed $data, float $timeout = 0.5, int $dstWorkerId = -1): mixed;
+    public function taskWaitMulti(array $tasks, float $timeout = 0.5): false|array;
 
 }

Task/TestTask.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Kiri\Server\Task;
+
+class TestTask implements OnTaskInterface
+{
+
+
+    public function __construct($user, $friend)
+    {
+    }
+
+
+    /**
+     * @param int $task_id
+     * @param int $src_worker_id
+     * @return int
+     */
+    public function process(int $task_id, int $src_worker_id): int
+    {
+        return 0;
+    }
+
+}

composer.json

@@ -9,7 +9,7 @@
     }
   ],
   "require": {
-    "php": ">=8.0",
+    "php": ">=8.4",
     "ext-json": "*",
     "composer-runtime-api": "^2.0",
     "psr/http-server-middleware": "^1.0",