As a (PHP) package developer, you sometimes have classes that are meant for internal use – inside the package itself – only. PHP has no built-in solution for this, but using a DocBlock Tag one can indicate its intended use. As Nuno Maduro explains:
Maybe in the future, the PHP language will have the
internal
class access modifier, it would prevent people from using internal classes from your library. Meanwhile, the PHP@internal
tag can be used to denote that the associated class/method is internal to the library. It’s supported by PHPStorm and it warns people that those classes/methods are not meant to be used
Via Freek (who recently redesigned his blog by the way)