Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:113036
MIME-Version: 1.0
References: <eadd4a32-a05b-463b-a91f-a5d353c577b2@www.fastmail.com> <ffd16d04-498b-46ac-95e7-b4692900a6d3@www.fastmail.com>
In-Reply-To: <ffd16d04-498b-46ac-95e7-b4692900a6d3@www.fastmail.com>
Date: Mon, 1 Feb 2021 14:16:26 +0100
Message-ID: <CAF+90c8DrGObn36Oeb6Tf90Zw7yPkG9MkabZFti5G0S01nXZ2A@mail.gmail.com>
To: Larry Garfield <larry@garfieldtech.com>
Cc: php internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary="00000000000048a71f05ba462aa7"
Subject: Re: [PHP-DEV] Re: [RFC] Enumerations, Round 2
From: nikita.ppv@gmail.com (Nikita Popov)

--00000000000048a71f05ba462aa7
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Fri, Jan 29, 2021 at 6:18 PM Larry Garfield <larry@garfieldtech.com>
wrote:

> On Mon, Dec 28, 2020, at 2:21 PM, Larry Garfield wrote:
> > Hello, Internalians!
> >
> > After considerable discussion and effort, Ilija and I are ready to
> > offer you round 2 on enumerations.  This is in the spirit of the
> > previous discussion, but based on that discussion a great deal has been
> > reworked.  The main change is that Enumeration Cases are now object
> > instances of the Enumeration class rather than their own class.  Most
> > of the other changes are knock-on effects of that.
> >
> > Of particular note:
> >
> > * Cases may not have methods or constants on them.  They're just dumb
> values.
> > * Enums themselves may have methods, static methods, or constants.
> > * Traits are supported, as long as they don't have properties.
> > * The value() method on scalar enums is now a property.
> >
> > The full RFC is here, and I recommend reading it again in full given
> > how much was updated.
> >
> > https://wiki.php.net/rfc/enumerations
> >
> > The implementation is 98% complete; there's still a few lagging bits in
> > reflection, and some opcache bugs that Ilija is still stomping on.
> >
> > There are a few outstanding questions listed that we would like
> > feedback on.  We're not entirely certain which direction to go with
> > them, for reasons explained in the RFC.  Input on those is especially
> > welcome.
> >
> > Happy New Year.  May it be enumerable.
>
> And we're back again.  The RFC has been updated with a steady stream of
> smaller improvements based on feedback and testing, and is now in its Fin=
al
> Form(tm) (we think).  The only major change worth noting is that we renam=
ed
> things. :-)
>
> An enum with no scalar backing is now called a Pure Enum, made up of Pure
> Cases.  One that does have backing values is called a Backed Enum, made u=
p
> of Backed Cases.  That change is mainly to allow for future expansion to
> non-scalar backing static values, should the use case arise.  Reflection
> was also reworked a bit to make it more logical.
>
> https://wiki.php.net/rfc/enumerations
>
> At this point, Ilija and I consider the RFC done and ready for a vote.
> Baring any major issues being brought up, we plan to start the vote in th=
e
> first half of next week, probably Tuesday-ish.  If you have any other bug
> reports or tweaks, please speak now or forever hold your patches.
>
> --Larry Garfield
>

Two notes:

> =E2=80=9Cenum=E2=80=9D becomes a language keyword, with the usual potenti=
al for naming
conflicts with existing global constants.

... and class names, which is probably more relevant here. It's worth
noting that this RFC renders many existing enum libraries unusable, such as
myclabs/php-enum, which defines an "abstract class Enum".

> Both Pure Enums and Backed Enums implement an internal interface named
IterableEnum

I really don't like this interface name. We have an "iterable" type in PHP,
and having an IterableEnum that is not ... iterable would be somewhat
confusing. IIRC you previously called this UnitEnum, which is also not
great in that "unitary enum" is not particularly well-established
terminology, but I think it's still better than IterableEnum.

Regards,
Nikita

--00000000000048a71f05ba462aa7--