Share
Embed
Phluxorでアクターモデルを 理解・体験しよう / toolkit-for-flexible-actor-models-in-php-phluxor
A toolkit for flexible actor models in PHP, empowering the PHP ecosystem.
https://github.com/ytake/phluxor
yuuki takezawa
June 24, 2024
Transcript
81 slides
-
Pro fi le • ᖒ ༗و a.k.a ytake • ઍגࣜձࣾ
CTO / ٕज़ސ ωοτϓϩςΫγϣϯζ΄͔ • Go / Scala • ΞΫλʔϞσϧେ͖ -
Phluxor • ScalaͳͲͰ͓ͳ͡ΈͷAkka / Pekko • Go.NETͰΘΕ͍ͯΔ Proto.Actor • ͜ΕΒͱಉ֓͡೦ʹج͖ͮ
PHPͰΞΫλʔϞσϧΛ࣮ݱ͢ΔͨΊͷͷ͕Phluxor • ΫϥελɾҰ෦ϧʔλʔػೳݱࡏ࣮தʢϲ݄Ҏʹఏڙʣ -
Phluxor͕αϙʔτ͍ͯ͠Δͷ • ΞΫλʔͷجຊཁૉશൠ • EventStream • Supervision • Future (Async/AwaitΈ͍ͨͳͷ)
• Behavior • Persistence • Router • DeadLetter • Middleware • Reentrancy -
Supervision / Strategy • ෦ΠϕϯτͷWatchΛൃߦͯ͠ࢹͷؔੑΛ࣋ͭ • Ϋϥογϡ͢ΔͱStrategyʹج͍ͮͨઓུͰ෮چΛࢼΈΔ SwooleͷTimerͳͲΛར༻ • ϥΠϑαΠΫϧؔ࿈Ͱ
෦ϝοηʔδͷStartedTerminatedɺRecoveringͳͲ͕͋Γ -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } NF[[JPTXPPMFΛτϦΨʔʹ ΞΫλʔγεςϜىಈ ϦΫΤετͷͨͼʹΞΫλʔγεςϜΛ ىಈ͢Δͱɺ ߴίετͰঢ়ଶҡ͕࣋Ͱ͖ͳ͍ͨΊ -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } SPPUΞΫλʔγεςϜτοϓϨϕϧ ઃܭʹΑͬͯ τοϓϨϕϧΞΫλʔΛෳ࡞ͬͯ0, -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } ΞΫλʔੜ࣌ͷઃఆ ʢͳʹͳ͍ͱ͖ͨͩͷΞΫλʔʣ -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } ΞΫλʔੜ࣌ʹ໊લΛ͚ͭΔ 4QBXO/BNFE -
readonly class BootAppActor { public function __construct( private ContainerInterface $container
) { } public function __invoke(WorkerStartEvent $event): void { $system = ActorSystem::create(); $spawned = $system->root()->spawnNamed( Props::fromProducer(fn() => new BoxOffice()), AppActor::NAME ); if ($this->container instanceof ServiceManager) { $this->container->setService(AppActor::class, new AppActor($system->root(), $spawned->getRef())); return; } throw new RuntimeException('Container is not a ServiceManager'); } } #PY0 ff i DFͷΞΫλʔΛ CPY@P ff i DFͱ͍͏໊લͰ τοϓϨϕϧʹஔ -
public function handle(ServerRequestInterface $request): ResponseInterface { $actor = $this->appActor; $post
= $request->getParsedBody(); if (! isset($post['tickets'])) { return new JsonResponse(['error' => 'tickets is required'], 400); } $eventName = $request->getAttribute('name'); $future = $actor->root->requestFuture( $actor->actorRef, new EventDescription($eventName, (int) $post['tickets']), 2000 ); $fr = $future->result(); if ($fr->error() !== null) { return new JsonResponse(['error' => $fr->error()], 400); } $v = $fr->value(); return match (true) { $v instanceof EventCreated => new JsonResponse(['message' => 'event created', 'event' => $eventName]), $v instanceof EventExists => new JsonResponse(['message' => 'event exists', 'event' => $eventName], 409), default => new JsonResponse(['message' => 'unknown'], 400), }; } -
public function handle(ServerRequestInterface $request): ResponseInterface { $actor = $this->appActor; $post
= $request->getParsedBody(); if (! isset($post['tickets'])) { return new JsonResponse(['error' => 'tickets is required'], 400); } $eventName = $request->getAttribute('name'); $future = $actor->root->requestFuture( $actor->actorRef, new EventDescription($eventName, (int) $post['tickets']), 2000 ); $fr = $future->result(); if ($fr->error() !== null) { return new JsonResponse(['error' => $fr->error()], 400); } $v = $fr->value(); return match (true) { $v instanceof EventCreated => new JsonResponse(['message' => 'event created', 'event' => $eventName]), $v instanceof EventExists => new JsonResponse(['message' => 'event exists', 'event' => $eventName], 409), default => new JsonResponse(['message' => 'unknown'], 400), }; } τοϓϨϕϧΞΫλʔʹ νέοτ࡞Λґཔ -
public function handle(ServerRequestInterface $request): ResponseInterface { $actor = $this->appActor; $post
= $request->getParsedBody(); if (! isset($post['tickets'])) { return new JsonResponse(['error' => 'tickets is required'], 400); } $eventName = $request->getAttribute('name'); $future = $actor->root->requestFuture( $actor->actorRef, new EventDescription($eventName, (int) $post['tickets']), 2000 ); $fr = $future->result(); if ($fr->error() !== null) { return new JsonResponse(['error' => $fr->error()], 400); } $v = $fr->value(); return match (true) { $v instanceof EventCreated => new JsonResponse(['message' => 'event created', 'event' => $eventName]), $v instanceof EventExists => new JsonResponse(['message' => 'event exists', 'event' => $eventName], 409), default => new JsonResponse(['message' => 'unknown'], 400), }; } SFRVFTU'VUVSF BTZODBXBJUͷΑ͏ʹ ޙʹૹΒΕͯ͘Δ͕ར༻Ͱ͖Δ -
public function handle(ServerRequestInterface $request): ResponseInterface { $actor = $this->appActor; $post
= $request->getParsedBody(); if (! isset($post['tickets'])) { return new JsonResponse(['error' => 'tickets is required'], 400); } $eventName = $request->getAttribute('name'); $future = $actor->root->requestFuture( $actor->actorRef, new EventDescription($eventName, (int) $post['tickets']), 2000 ); $fr = $future->result(); if ($fr->error() !== null) { return new JsonResponse(['error' => $fr->error()], 400); } $v = $fr->value(); return match (true) { $v instanceof EventCreated => new JsonResponse(['message' => 'event created', 'event' => $eventName]), $v instanceof EventExists => new JsonResponse(['message' => 'event exists', 'event' => $eventName], 409), default => new JsonResponse(['message' => 'unknown'], 400), }; } GVUVSFͷ݁Ռ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; #PY0 ff i DFΞΫλʔ SFDFJWFϝιουͷΈ࣮ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; ྲྀΕͯ͘Δϝοηʔδ DPOUFYUNFTTBHF Ͱऔಘ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; &WFOU%FTDSJQUJPOϝοηʔδͷ ରԠΛهड़ NBUDIͰ0, -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; ࣄΛґཔ͢ΔࢠΞΫλʔΛੜ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; ΠϕϯτνέοτΛ୲͢Δ ΞΫλʔ ࣝผͰ͖Δ໊લΛ͚ͭΔྫ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; ࣝผՄೳͳΞΫλʔ͕ઌʹ ىಈ͍ͯ͠Δঢ়ଶ͕͢Ͱʹ͋Δ ͜ͷͨΊ࡞͠ͳ͍ -
public function receive(ContextInterface $context): void { $msg = $context->message(); switch
(true) { case $msg instanceof EventDescription: $result = $context->spawnNamed( Props::fromProducer(fn() => new TicketSeller()), $msg->name ); if ($result->isError() instanceof NameExistsException) { // ΞΫλʔ͕ੜࡁΈͷ߹ੜࡁΈͰ͋Δ͜ͱΛ௨͠·͢ $context->respond(new EventExists()); break; } $context->send($result->getRef(), new Add($msg->name, $msg->tickets, $context->sender())); break; νέοτൢചΞΫλʔѼʹ "EEϝοηʔδΛૹ৴ -
BoxO ffi ce ΞΫλʔ TicketSeller ΞΫλʔ TicketSeller ΞΫλʔ TicketSeller ΞΫλʔ
TicketSeller ΞΫλʔ TicketSeller ΞΫλʔ TicketSeller ΞΫλʔ -
<?php declare(strict_types=1); namespace App\Message; use Phluxor\ActorSystem\Ref; class Add { public
function __construct( readonly public string $name, readonly public int $tickets, readonly public Ref $replyTo ) { } } -
<?php declare(strict_types=1); namespace App\Message; use Phluxor\ActorSystem\Ref; class Add { public
function __construct( readonly public string $name, readonly public int $tickets, readonly public Ref $replyTo ) { } } Πϕϯτ໊ νέοτຕ νέοτ࡞݁Ռૹ৴ઌ -
class TicketSeller implements ActorInterface { private int $tickets = 0;
private string $name = ''; private string $id = ''; public function receive(ContextInterface $context): void { $msg = $context->message(); switch (true) { case $msg instanceof Add: // Ұ෦ൈਮ $this->name = $msg->name; $this->tickets = $msg->tickets; $this->id = (string)$context->self(); $context->send($msg->replyTo, new EventCreated($msg->name, $msg->tickets)); break; } } } -
class TicketSeller implements ActorInterface { private int $tickets = 0;
private string $name = ''; private string $id = ''; public function receive(ContextInterface $context): void { $msg = $context->message(); switch (true) { case $msg instanceof Add: // Ұ෦ൈਮ $this->name = $msg->name; $this->tickets = $msg->tickets; $this->id = (string)$context->self(); $context->send($msg->replyTo, new EventCreated($msg->name, $msg->tickets)); break; } } } 5JDLFU4FMMFS͕ "EEϝοηʔδΛड͚औͬͨΒ -
class TicketSeller implements ActorInterface { private int $tickets = 0;
private string $name = ''; private string $id = ''; public function receive(ContextInterface $context): void { $msg = $context->message(); switch (true) { case $msg instanceof Add: // Ұ෦ൈਮ $this->name = $msg->name; $this->tickets = $msg->tickets; $this->id = (string)$context->self(); $context->send($msg->replyTo, new EventCreated($msg->name, $msg->tickets)); break; } } } 5JDLFU4FMMFSʹঢ়ଶΛอଘ 1FSTJTUFODFར༻࣌ɺ ঢ়ଶมߋຖʹอଘ͞ΕΔ -
class TicketSeller implements ActorInterface { private int $tickets = 0;
private string $name = ''; private string $id = ''; public function receive(ContextInterface $context): void { $msg = $context->message(); switch (true) { case $msg instanceof Add: // Ұ෦ൈਮ $this->name = $msg->name; $this->tickets = $msg->tickets; $this->id = (string)$context->self(); $context->send($msg->replyTo, new EventCreated($msg->name, $msg->tickets)); break; } } } νέοτൢചΠϕϯτͷ ঢ়ଶ͕อଘ͞ΕͨΒ &WFOU$SFBUFEΠϕϯτΛฦ٫ ʢSFQMZ5Pʹࢦఆ͞ΕͨΞΫλʔѼʣ -
private function fetchEvents(ContextInterface $context): array { $wg = new WaitGroup();
$events = []; foreach ($context->children() as $child) { $wg->add(); $future = $context->requestFuture($child, new GetEvent(), 2000); $fr = $future->result(); if ($fr->error() !== null) { $wg->done(); continue; } if ($fr->value() instanceof Event) { $events = array_merge($events, [$fr->value()]); $wg->done(); } } $wg->wait(); return $events; } -
private function fetchEvents(ContextInterface $context): array { $wg = new WaitGroup();
$events = []; foreach ($context->children() as $child) { $wg->add(); $future = $context->requestFuture($child, new GetEvent(), 2000); $fr = $future->result(); if ($fr->error() !== null) { $wg->done(); continue; } if ($fr->value() instanceof Event) { $events = array_merge($events, [$fr->value()]); $wg->done(); } } $wg->wait(); return $events; } ͕ࣗੜͨ͠ࢠΞΫλʔ ʢ֤ΠϕϯτνέοτൢചΞΫλʔʣ ʹݱࡏͷঢ়ଶΛਘͶΔ -
private function fetchEvents(ContextInterface $context): array { $wg = new WaitGroup();
$events = []; foreach ($context->children() as $child) { $wg->add(); $future = $context->requestFuture($child, new GetEvent(), 2000); $fr = $future->result(); if ($fr->error() !== null) { $wg->done(); continue; } if ($fr->value() instanceof Event) { $events = array_merge($events, [$fr->value()]); $wg->done(); } } $wg->wait(); return $events; } ͯ͢ͷνέοτൢചঢ়گΛϚʔδ