new.internalTrait

Code example

<?php declare(strict_types = 1);

namespace Vendor {
	/** @internal */
	trait InternalTrait {
		public function doSomething(): void {}
	}
}

namespace App {
	$obj = new \Vendor\InternalTrait(); // error: Instantiation of internal trait Vendor\InternalTrait.
}

Why is it reported?

The code attempts to instantiate a trait marked as @internal. Traits cannot be instantiated directly, and on top of that, this trait is an internal implementation detail of its package. Internal traits may change or be removed in any release without following semantic versioning.

Note: triggering this identifier requires instantiating a trait, which PHP does not allow. PHPStan therefore always also reports a new.trait error, and in practice the new.internalTrait identifier is not reported alongside it.

How to fix it

Traits are not meant to be instantiated. Use a class from the package's public API instead:

 namespace App {
-	$obj = new \Vendor\InternalTrait();
+	$obj = new \Vendor\PublicService();
 }