Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:123346
Precedence: bulk
MIME-Version: 1.0
Date: Sat, 18 May 2024 16:00:25 +0200
Message-ID: <CAPzBOBMpOztgNQx35ZnP4c5ZHV-Ax1ETH0=YMzVT9Hq9cdyyDQ@mail.gmail.com>
Subject: [PHP-DEV] [Discussion] "Internal" attribute and warning
To: internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
From: landers.robert@gmail.com (Robert Landers)

Hello internals,

I've been thinking about having an "internal" attribute that will emit
a warning if called from outside it's left-most namespace.

It might look something like this:

namespace MyCompany\PackageA {
  #[\Internal] function doStuff() {}
}

namespace OtherCompany\PackageB {
  \MyCompany\PackageA\doStuff(); // warning emitted
}

namespace MyCompany\PackageB {
  \MyCompany\PackageB\doStuff(); // left-most part of namespace
matches, no warning
}

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.

Any thoughts?

Robert Landers
Software Engineer
Utrecht NL