Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:128905
Precedence: list
MIME-Version: 1.0
References: <CAMW7n8DGbFnQzjt3s9CcOBwhp+MUOV+K3U=yY=ULOTdUXaOLHQ@mail.gmail.com>
 <25be6748-d8c3-4f1a-bf81-297cea72f8db@alec.pl>
In-Reply-To: <25be6748-d8c3-4f1a-bf81-297cea72f8db@alec.pl>
Date: Wed, 22 Oct 2025 20:01:24 +0300
Message-ID: <CAMW7n8COoVPnzJx3u9mtBxHZn92xXYUija0T8GfP9d0rTgXw3g@mail.gmail.com>
Subject: Re: [PHP-DEV] PHP True Async RFC Stage 4
To: Aleksander Machniak <alec@alec.pl>
Cc: internals@lists.php.net
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
From: edmond.ht@gmail.com (Edmond Dantes)

Hello.

> - The glossary in "Overview" is good, but probably incomplete. The
> examples there, with no description, do not help much and could be
> removed, imo.

Do I understand correctly that I should remove the examples without
descriptions?
Or would it be better to add descriptions to them?
Although the last examples might not be very illustrative or easy to grasp.

> the "Scheduler and Reactor" section does not explain much over what's in =
the glossary.

What else do you think could be added?
The internal implementation doesn=E2=80=99t belong in the scope of the RFC,=
 it
can change.
They don=E2=80=99t have any special API in the PHP userland.
The reactor can only be used directly at the C/C++ level, meaning
within a PHP extension.
It=E2=80=99s also intentionally impossible to directly affect the Scheduler=
=E2=80=99s behavior.

> One question. Seems like we don't really need delay() function. Why not
> add an argument to the suspend() function? I think it would make the
> code easier to understand, considering seeing suspend(1000) versus
> delay(1000).

That didn=E2=80=99t occur to me.
Interesting idea. You=E2=80=99re saying it would make the code more readabl=
e.
But wouldn=E2=80=99t it be confusing since the functions have slightly
different semantic purposes?
As a non-native English speaker, I don=E2=80=99t really feel the difference
between delay and suspend. They seem close in meaning. But is that the
case for others?

Thanks, Ed.