← All results

External signature support through companion helper files

Group: Stubs and external signatures · Category: ecosystem · File: stubs_external_signature_support.php

References: - python-typing distribution / external type information inspiration - PHP analyzer support for separately supplied symbols

Analyzer results

AnalyzerVersionResultDiagnostics
phan 6.0.7Phan 6.0.7 php-ast version 1.1.3 PHP version used to run Phan: 8.5.9 Pass
stubs_external_signature_support.php:37: Argument 1 ($clock) is new InvalidClock() of type \Conformance\Tests\StubsExternalSignatureSupport\InvalidClock but \Conformance\Tests\StubsExternalSignatureSupport\takesClock() takes \Conformance\Tests\StubsExternalSignatureSupport\ExternalClock defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/stubs_external_signature_support.php:32 [PhanTypeMismatchArgumentReal]
phpstan 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Pass reported Lv.5+
stubs_external_signature_support.php:37: Parameter #1 $clock of function Conformance\Tests\StubsExternalSignatureSupport\takesClock expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, Conformance\Tests\StubsExternalSignatureSupport\InvalidClock given. [identifier=argument.type] [reported-from-level=5]
With strict-rules
stubs_external_signature_support.php:37: Parameter #1 $clock of function Conformance\Tests\StubsExternalSignatureSupport\takesClock expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, Conformance\Tests\StubsExternalSignatureSupport\InvalidClock given. [identifier=argument.type]
psalm 6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac
next: 7.0.0-beta19
Pass
stubs_external_signature_support.php:37: Argument 1 of Conformance\Tests\StubsExternalSignatureSupport\takesClock expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, but Conformance\Tests\StubsExternalSignatureSupport\InvalidClock provided [InvalidArgument]
mago 1.46.0mago 1.46.0 Pass
stubs_external_signature_support.php:37: Possible argument type mismatch for argument #1 of `Conformance\Tests\StubsExternalSignatureSupport\takesClock`: expected `Conformance\Tests\StubsExternalSignatureSupport\ExternalClock`, but possibly received `Conformance\Tests\StubsExternalSignatureSupport\InvalidClock`. [possibly-invalid-argument]
mir 0.70.1mir 0.70.1 Pass
stubs_external_signature_support.php:37: InvalidArgument: Argument $clock of takesClock() expects 'Conformance\Tests\StubsExternalSignatureSupport\ExternalClock', got 'Conformance\Tests\StubsExternalSignatureSupport\InvalidClock' [MIR0201]
phpantom 0.9.0phpantom_lsp 0.9.0 Fail
stubs_external_signature_support.php:15: Class 'Conformance\Tests\StubsExternalSignatureSupport\ExternalClock' not found [unknown_class]
stubs_external_signature_support.php:32: Class 'Conformance\Tests\StubsExternalSignatureSupport\ExternalClock' not found [unknown_class]
stubs_external_signature_support.php:37: Argument 1 ($clock) expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, got Conformance\Tests\StubsExternalSignatureSupport\InvalidClock [type_mismatch_argument]
Expectation diff
Line 15: Unexpected errors ["Class 'Conformance\\Tests\\StubsExternalSignatureSupport\\ExternalClock' not found [unknown_class]"]
Line 32: Unexpected errors ["Class 'Conformance\\Tests\\StubsExternalSignatureSupport\\ExternalClock' not found [unknown_class]"]
intelephense 1.18.5intelephense 1.18.5 Pass
stubs_external_signature_support.php:37: Expected type 'Conformance\Tests\StubsExternalSignatureSupport\ExternalClock'. Found 'Conformance\Tests\StubsExternalSignatureSupport\InvalidClock'. [P1006]
phpy 0.2.0phpy 0.2.0 Pass
stubs_external_signature_support.php:37: Argument '1' passed to Conformance\Tests\StubsExternalSignatureSupport\takesClock() is expected to be of type Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, Conformance\Tests\StubsExternalSignatureSupport\InvalidClock given
qodana 262.8665.325Qodana 262.8665.325 Pass
stubs_external_signature_support.php:37: Parameter 'new InvalidClock()' type is not compatible with declaration [PhpParamsInspection]
noverify 0.5.5NoVerify, version 0.5.5: built on: 2025.04.22 14:36:46 OS: r-kuchinskas arm64 Commit: 4774b82f8adc53fbef38f95e97af4b953b4d1529 Fail

No diagnostics reported.

Expectation diff
Line 37: Expected 1 error(s)
steins 0.1.5steins 0.1.5 (2026-08-12 revision 39b4cc1) Pass
stubs_external_signature_support.php:37: argument new InvalidClock() to takesClock() cannot become Conformance\Tests\StubsExternalSignatureSupport\ExternalClock $clock — proven TypeError (strict mode) [type.argument-mismatch]
phpstan-strict 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Pass
stubs_external_signature_support.php:37: Parameter #1 $clock of function Conformance\Tests\StubsExternalSignatureSupport\takesClock expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, Conformance\Tests\StubsExternalSignatureSupport\InvalidClock given. [identifier=argument.type]
psalm-next 7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433 Pass
stubs_external_signature_support.php:37: Argument 1 of Conformance\Tests\StubsExternalSignatureSupport\takesClock expects Conformance\Tests\StubsExternalSignatureSupport\ExternalClock, but Conformance\Tests\StubsExternalSignatureSupport\InvalidClock provided [InvalidArgument]

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\StubsExternalSignatureSupport;

/**
 * External signature support through companion helper files.
 *
 * References:
 * - python-typing distribution / external type information inspiration
 * - PHP analyzer support for separately supplied symbols
 */

final class ValidClock implements ExternalClock
{
    #[\Override]
    public function timestamp(): int
    {
        return 1700000000;
    }
}

final class InvalidClock
{
    public function time(): string
    {
        return 'now';
    }
}

function takesClock(ExternalClock $clock): void
{
}

takesClock(new ValidClock());
takesClock(new InvalidClock()); // E: object does not satisfy the companion external signature

Support: _stubs_external_signature_support.php

<?php

declare(strict_types=1);

namespace Conformance\Tests\StubsExternalSignatureSupport;

interface ExternalClock
{
    public function timestamp(): int;
}