@internal

The @internal tag marks an element as belonging to the internal workings of its own package rather than to its public API: consumers should not depend on it, since it may change or disappear without a deprecation notice. Used inline inside a description, it instead marks just the surrounding portion of text as meant only for the package's own maintainers, letting documentation generators strip that portion from public-facing output while keeping the rest of the description intact.

Parsing an @internal tag produces an InternalTag instance. Being a pure marker, it adds nothing beyond the $name and optional $description every Tag already carries.

Defined by the PSR-19 draft PHPDoc Tags proposal and phpDocumentor's tag reference.