phpcon okinawa 2024 Phluxor Examples

Training the Actor Model with Phluxor.

Although this is quite different from typical PHP processing,

it is a good way to learn about the actor model.

All actors in the actor model are executed asynchronously via coroutines.

No special middleware is used.
100% PHP (with Swoole) is used to implement the actor model.

日本語向けの解説はProto Actor(Go)をベースにした解説になっていますが、
下記で解説していますので、参考にしてください。
基本的な概念や構造、メソッドのインターフェースもほぼ同じように提供しています。

日本語記事はこちら.

Class Room Example

The flow of actor creation is as follows.

flowchart TD
    subgraph ActorSystem
        classroom --> teacher
        teacher --> student
    end

Loading

The hierarchy would be as follows.

• Classroom / top level actor
  • Teacher / aggregate actor & child actor
    • Students(20) / child actor

We will represent the following classroom activities in school life using the actor model:

• Class time begins
• The teacher comes to the classroom
• Test begins
• Write your answers on the answer sheet
• Submit test answer sheets
• After everyone has submitted, the class ends

Class time begins

flowchart TD
    subgraph ActorSystem
        Root -->|Start Class Instruction| ClassroomActor("Classroom Actor\n(Math)")
    end

Loading

The teacher comes to the classroom

In this example,
"The teacher is coming" is expressed as a classroom actor creating a teacher actor.

flowchart TD
    subgraph ActorSystem
        ClassroomActor("Classroom Actor(Math)") -->|Spawn| Teacher("Teacher Actor")
    end

Loading

Test begins

The Classroom Actor Sends a Message to the Teacher Actor to Prepare for the Test Start

flowchart TD
    subgraph ActorSystem
        ClassroomActor("Classroom Actor(Math)") -->|Prepare for Test Start| Teacher("Teacher Actor")
    end

Loading

Write your answers on the answer sheet

flowchart TD
    subgraph ActorSystem
        Teacher("Teacher Actor") -->|Start Test| StudentActor("Student Actors")
    end

Loading

Submit test answer sheets

flowchart TD
    subgraph ActorSystem
        StudentActor("Student Actor") -->|Submit Answer Sheet| Teacher("Teacher Actor")
    end

Loading

After everyone has submitted, the class ends

flowchart TD
    subgraph ActorSystem
        StudentActor("Student Actor") -->|Submit Answer Sheet| Teacher("Teacher Actor")
        Teacher("Teacher Actor") -->|Test Ends| ClassroomActor("Classroom Actor\n(Math)")
    end

Loading

Implementation

The actual message passing between actors is as follows.

flowchart TD
    subgraph ActorSystem
        ClassroomActor("Classroom Actor(Math)") -->|PrepareTest| Teacher("Teacher Actor")
        Teacher("Teacher Actor") -->|StartTest| StudentActor("Student Actor")
        StudentActor("Student Actor") -->|SubmitTest| Teacher("Teacher Actor")
    end

Loading

generate multiple student actors as follows:

flowchart TD
    subgraph ActorSystem
        Teacher("Teacher Actor") -->|Spawn| student-1
        Teacher("Teacher Actor") -->|Spawn| student-2
        Teacher("Teacher Actor") -->|Spawn| student-3
        Teacher("Teacher Actor") -->|Spawn| student-4
        Teacher("Teacher Actor") -->|Spawn| student-5
    end

Loading

Setup

$ docker compose up -d 
$ docker compose exec phluxor composer install

Actor Model Easy Example

$ docker compose exec phluxor php main.php

Classroom, Teacher, Student Example

$ docker compose exec phluxor php classroom.php