Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:127350
Precedence: bulk
MIME-Version: 1.0
References: <CAMW7n8BVd-dqcy7tabMEcOOLZPcqWj9o64tEVPepvHxcQ2BPzQ@mail.gmail.com>
In-Reply-To: <CAMW7n8BVd-dqcy7tabMEcOOLZPcqWj9o64tEVPepvHxcQ2BPzQ@mail.gmail.com>
Date: Wed, 14 May 2025 10:09:18 +0300
Message-ID: <CAMW7n8DGAdqU15uz=ezp8AbehpWZmPSsNhew=9PcL7hHpsWL5w@mail.gmail.com>
Subject: [PHP-DEV] Re: PHP True Async RFC Stage 3
To: php internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
From: edmond.ht@gmail.com (Edmond Dantes)

Hello, everyone.

While the code is being developed and changes for the RFC are in
progress, I=E2=80=99d like to share a real-world situation.

This is one of those cases that once again proves why software design
cannot happen without writing real code =E2=80=94 why architecture is
impossible without practice.

```php
function any(iterable $triggers): Awaitable {}
function all(iterable $triggers): Awaitable {}
function anyOf(int $count, iterable $triggers): Awaitable {}
function captureErrors(Awaitable $awaitable): Awaitable {}
```

In the latest version of the **RFC**, I tried to split the awaitAll
function into a separate `all()` function, so it could be combined
with await. This solution seemed very elegant to me, as it aligns with
the principle of separation of concerns in design.

What could go wrong?

As I began implementing the concurrent iterator (i.e., refactoring the
old code using the new approaches), it became clear that the Awaitable
object returned by functions must be able to be awaited multiple
times. But that means the iterator may need to maintain complex
internal state to correctly pause and resume execution. I became
curious about how many edge cases could arise in this situation and...
it terrified me.

So much for =E2=80=9Celegant design.=E2=80=9D All that glitters is not gold=
.

It might be possible to find a golden mean between implementation and
interface elegance.

Have a good day.
-- Ed