← All results

Generator TSend, and foreach over a generator that requires send()

Group: PHPDoc generics · Category: phpdoc · File: generics_generators_send_type.php

phpdoc_advanced_generator_generic measures TValue; generics_generator_get_return measures TReturn. This file measures TSend: send() rejects the wrong type, and iterating a generator whose send type is non-nullable is unsafe because foreach never sends. Source: vimeo/psalm#10697 (5.23.0). References: - psalm#10697 - phpdoc_advanced_generator_generic - generics_generator_get_return

Analyzer results

AnalyzerVersionResultDiagnostics
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/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
phpstan 2.3.5PHPStan - PHP Static Analysis Tool 2.3.5 Partly enforced (1/2) reported Lv.5+
generics_generators_send_type.php:58: Parameter #1 $value of method Generator<int,string,int,void>::send() expects int, string given. [reported-from-level=5]
With strict-rules
generics_generators_send_type.php:58: Parameter #1 $value of method Generator<int,string,int,void>::send() expects int, string given.
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
psalm 6.20.9Psalm 6.20.9@f67170ac3c3b931f5088681e21d6c8babc601c08
next: 7.0.4
Enforced
generics_generators_send_type.php:48: Cannot iterate over generator with non-null send() type Generator<int, string, int, void> [InvalidIterator]
generics_generators_send_type.php:58: Argument 1 of Generator::send expects int, but 'x' provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
mago 1.59.0mago 1.59.0 Partly enforced (1/2)
generics_generators_send_type.php:58: Invalid argument type for argument #1 of `Generator::send`: expected `int`, but found `string('x')`. [invalid-argument]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
mir 0.91.0mir 0.91.0 Partly enforced (1/2)
generics_generators_send_type.php:58: InvalidArgument: Argument $value of send() expects 'int', got '"x"' [MIR0201]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
phpantom 0.11.1phpantom_lsp 0.11.1 Partly enforced (1/2)
generics_generators_send_type.php:58: Argument 1 ($value) expects int, got 'x' [type_mismatch_argument]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
intelephense 1.18.5intelephense 1.18.5 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
phpactor 2026.10.07.0Phpactor 2026.10.07.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
phpy 1.0.19490phpy 1.0.19490 Partly enforced (1/2)
generics_generators_send_type.php:58: Argument '1' passed to send() is expected to be of type int, string given
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
qodana 262.11879.104PhpStorm 262.11879.104 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
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/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
steins 0.1.8steins 0.1.8 (2026-09-21 revision 76306a9) Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
Expectation diff
Line 58: Expected 1 error(s)
phpstan-strict 2.3.5PHPStan - PHP Static Analysis Tool 2.3.5 Partly enforced (1/2)
generics_generators_send_type.php:58: Parameter #1 $value of method Generator<int,string,int,void>::send() expects int, string given.
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
psalm-next 7.0.4Psalm 7.0.4@fa5b1f6e665cb743838ffd865b8fc96207f9409f Enforced
generics_generators_send_type.php:48: Cannot iterate over generator with non-null send() type Generator<int, string, int, void> [InvalidIterator]
generics_generators_send_type.php:58: Argument 1 of Generator::send expects int, but 'x' provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\GenericsGeneratorsSendType;

/**
 * `Generator` TSend, and foreach over a generator that requires `send()`.
 *
 * `phpdoc_advanced_generator_generic` measures TValue;
 * `generics_generator_get_return` measures TReturn. This file measures
 * TSend: `send()` rejects the wrong type, and iterating a generator whose
 * send type is non-nullable is unsafe because foreach never sends.
 *
 * Source: vimeo/psalm#10697 (5.23.0).
 *
 * References:
 * - https://github.com/vimeo/psalm/pull/10697
 * - phpdoc_advanced_generator_generic
 * - generics_generator_get_return
 */

/**
 * @return \Generator<int, string, void, void>
 */
function voidSend(): \Generator // T: \Generator<int, string, void, void>
{
    yield 0 => 'a';
}

/**
 * @return \Generator<int, string, int, void>
 */
function intSend(): \Generator // T: \Generator<int, string, int, void>
{
    yield 0 => 'a';
}

function iteratesVoidSend(): void
{
    foreach (voidSend() as $value) {
        echo $value; // V: void send is safe to iterate
    }
}

function iteratesIntSend(): void
{
    foreach (intSend() as $value) { // E?: foreach does not send, so a non-nullable TSend is unsafe
        echo $value;
    }
}

function sendsOnIntSend(): void
{
    $generator = intSend();
    $generator->send(1); // V
    $other = intSend();
    $other->send('x'); // E: TSend is int, not string
}