`@phpstan-require-implements`

Group: Advanced PHPDoc types · Category: ecosystem · File: phpdoc_advanced_phpstan_require_implements.php

When a trait carries the tag, using classes must implement the named interface. References: - PHPStan phpdocs-basics: Enforcing implementing an interface for traits

Analyzer results

Analyzer	Version	Result	Diagnostics
phan	6.0.11Phan 6.0.11 php-ast version 1.1.3 PHP version used to run Phan: 8.5.11	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan	2.3.5PHPStan - PHP Static Analysis Tool 2.3.5	Enforced reported Lv.2+	phpdoc_advanced_phpstan_require_implements.php:29: Trait Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract requires using class to implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract, but Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser does not. [reported-from-level=2] With strict-rules phpdoc_advanced_phpstan_require_implements.php:29: Trait Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract requires using class to implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract, but Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser does not. Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm	6.20.9Psalm 6.20.9@f67170ac3c3b931f5088681e21d6c8babc601c08 next: 7.0.4	Enforced (pzoom≠)	phpdoc_advanced_phpstan_require_implements.php:31: Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract requires using class to implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract, but Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser does not [ImplementationRequirementViolation] pzoom (Psalm port) No diagnostics from pzoom. Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mago	1.59.0mago 1.59.0	Enforced	phpdoc_advanced_phpstan_require_implements.php:29: Class `Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser` must implement required interface `conformance\tests\phpdocadvancedphpstanrequireimplements\requiredcontract` [missing-required-interface] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mir	0.91.0mir 0.91.0	Enforced	phpdoc_advanced_phpstan_require_implements.php:31: InvalidTraitUse: Trait NeedsContract used incorrectly: Class Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser uses trait NeedsContract but does not implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract [MIR1300] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
phpantom	0.11.1phpantom_lsp 0.11.1	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
intelephense	1.18.5intelephense 1.18.5	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpactor	2026.10.07.0Phpactor 2026.10.07.0	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpy	1.0.19490phpy 1.0.19490	Enforced	phpdoc_advanced_phpstan_require_implements.php:31: trait Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract expects interface Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
qodana	262.11879.104PhpStorm 262.11879.104	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
noverify	0.5.5NoVerify, version 0.5.5: built on: 2025.04.22 14:36:46 OS: r-kuchinskas arm64 Commit: 4774b82f8adc53fbef38f95e97af4b953b4d1529	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
steins	0.1.8steins 0.1.8 (2026-09-21 revision 76306a9)	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan-strict	2.3.5PHPStan - PHP Static Analysis Tool 2.3.5	Enforced	phpdoc_advanced_phpstan_require_implements.php:29: Trait Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract requires using class to implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract, but Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser does not. Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm-next	7.0.4Psalm 7.0.4@fa5b1f6e665cb743838ffd865b8fc96207f9409f	Enforced	phpdoc_advanced_phpstan_require_implements.php:31: Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\NeedsContract requires using class to implement Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\RequiredContract, but Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements\BadUser does not [ImplementationRequirementViolation] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedPhpstanRequireImplements;

/**
 * Cross-tool handling of `@phpstan-require-implements`.
 *
 * When a trait carries the tag, using classes must implement the named
 * interface.
 *
 * References:
 * - PHPStan phpdocs-basics: Enforcing implementing an interface for traits
 */

interface RequiredContract
{
}

/**
 * @phpstan-require-implements RequiredContract
 */
trait NeedsContract // T: @phpstan-require-implements
{
}

// Missing the required interface (diagnostic may land on the class or the use).
final class BadUser // E?[req]: using class must implement RequiredContract
{
    use NeedsContract; // E?[req]: using class must implement RequiredContract
}

// Satisfies the requirement.
final class GoodUser implements RequiredContract // V
{
    use NeedsContract;
}