Back to Phpstan

sealed.deprecatedInterface

website/errors/sealed.deprecatedInterface.md

2.2.11004 B
Original Source

Code example

php
<?php declare(strict_types = 1);

/** @deprecated Use NewHandler instead */
interface OldHandler
{
}

/**
 * @phpstan-sealed OldHandler
 */
interface HandlerProvider
{
}

Why is it reported?

This error is reported by the phpstan-deprecation-rules extension.

The @phpstan-sealed PHPDoc tag references an interface that is marked as @deprecated. The @phpstan-sealed tag restricts which types are allowed to implement or extend the sealed type. Referencing a deprecated interface in this tag creates a dependency on a symbol that is scheduled for removal.

How to fix it

Replace the deprecated interface with its recommended replacement in the @phpstan-sealed tag:

diff-php
 <?php declare(strict_types = 1);

 /**
- * @phpstan-sealed OldHandler
+ * @phpstan-sealed NewHandler
  */
 interface HandlerProvider
 {
 }

If the containing declaration is itself deprecated, the error will not be reported.