Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:123004
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Precedence: bulk
Mime-Version: 1.0 (1.0)
Subject: Re: [PHP-DEV] [RFC] Casing of acronyms in class and method names
In-Reply-To: <4c56763c-2d65-4f64-b1ef-87e6ab88a473@bastelstu.be>
Cc: PHP internals <internals@lists.php.net>
Date: Sun, 7 Apr 2024 01:14:28 +0900
Message-ID: <A768672E-3A6E-454F-9FC5-3792F10FE438@sakiot.com>
References: <4c56763c-2d65-4f64-b1ef-87e6ab88a473@bastelstu.be>
To: =?utf-8?Q?Tim_D=C3=BCsterhus?= <tim@bastelstu.be>
From: saki@sakiot.com (Saki Takamachi)

Hi Tim,

> =EF=BB=BFHi
>=20
> On 4/6/24 17:54, Saki Takamachi wrote:
>> However, in the example from "RFC: Namespaces in bundled PHP extensions",=
 the acronyms are not camelcased. e.g. `FFI\FFI`, `OpenSSL`
>> In other words, the RFC can be interpreted as "excluding acronyms" implic=
itly.
>=20
> This is correct, because the current class naming policy specifies that ac=
ronyms must be written in UPPERCASE. Thus the examples are consistent with t=
he current policy.
>=20
>> Just to clarify: I agree with your RFC. However, I think it is best to av=
oid vague statements where the meaning changes depending on interpretation, i=
f possible.
>=20
> I've added namespaced examples:
>=20
> https://wiki.php.net/rfc/class-naming-acronyms?do=3Ddiff&rev2%5B0%5D=3D171=
2350524&rev2%5B1%5D=3D1712419286&difftype=3Dsidebyside
>=20
>> In fact, due to some ambiguity in the namespace RFC, I couldn't decide wh=
ether BCMath's namespace should be "BcMath" or "BCMath=E2=80=9D.
>=20
> With the current policy it should be "BCMath", if my RFC passes it should b=
e "BcMath". I think Bcmath would be fine as well, if you consider the extens=
ion name to be a single word.
>=20
> Best regards
> Tim D=C3=BCsterhus

Thanks for adding examples.

Maybe it's the "namespace is implicitly part of the class name" thing that f=
eels strange to me. Because not only classes but also functions and constant=
s can belong to it.=20

Regards.

Saki=