Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:123347
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Precedence: bulk
Mime-Version: 1.0 (1.0)
Subject: Re: [PHP-DEV] [Discussion] "Internal" attribute and warning
Date: Sat, 18 May 2024 23:17:02 +0900
Message-ID: <941D4083-5FB2-4327-A3EF-1FF71DEFFF41@sakiot.com>
References: <CAPzBOBMpOztgNQx35ZnP4c5ZHV-Ax1ETH0=YMzVT9Hq9cdyyDQ@mail.gmail.com>
Cc: internals <internals@lists.php.net>
In-Reply-To: <CAPzBOBMpOztgNQx35ZnP4c5ZHV-Ax1ETH0=YMzVT9Hq9cdyyDQ@mail.gmail.com>
To: Robert Landers <landers.robert@gmail.com>
From: saki@sakiot.com (Saki Takamachi)

Hi Robert,

> =EF=BB=BFHello internals,
>=20
> I've been thinking about having an "internal" attribute that will emit
> a warning if called from outside it's left-most namespace.
>=20
> It might look something like this:
>=20
> namespace MyCompany\PackageA {
>  #[\Internal] function doStuff() {}
> }
>=20
> namespace OtherCompany\PackageB {
>  \MyCompany\PackageA\doStuff(); // warning emitted
> }
>=20
> namespace MyCompany\PackageB {
>  \MyCompany\PackageB\doStuff(); // left-most part of namespace
> matches, no warning
> }
>=20
> This would allow for library maintainers to mark internal constructs
> as such and provide users with feedback that they are using code that
> may be changed without any notice.
>=20
> Any thoughts?
>=20
> Robert Landers
> Software Engineer
> Utrecht NL

It seems to be a similar concept to package-private in Java, is my understan=
ding correct?

Regards,

Saki=