Regression: RegexIterator::setMode ValueError cites __construct arg #3 — Zend setMode arg #1 (ext/spl/spl_iterators.c)

[PurHur]

Category

Regression: · php-src-strict · RegexIterator::setMode invalid mode ValueError citation

Problem

RegexIterator::setMode(99) on Zend throws ValueError: RegexIterator::setMode(): Argument #1 ($mode) must be RegexIterator::MATCH, …. VM throws the same constraint text but attributes it to RegexIterator::__construct(): Argument #3 ($mode) (constructor wording reused for the setter).

Probed 2026-08-16 — host Zend PHP 8.2+ vs php bin/vm.php.

Repro	Zend 8.2+	VM (2026-08-16)
(new RegexIterator(new ArrayIterator(['a']), '/a/'))->setMode(99)	ValueError: RegexIterator::setMode(): Argument #1 ($mode) must be …	ValueError: RegexIterator::__construct(): Argument #3 ($mode) must be …

php-src reference

• php/php-src ext/spl/spl_iterators.c — zim_RegexIterator_setMode ValueError for invalid mode
• php/php-src ext/spl/spl_iterators.stub.php — setMode(int $mode): void

PHP implementation target

• ext/spl/ RegexIterator builtin / mode validation helper — emit ValueError with RegexIterator::setMode(): Argument #1 ($mode) (do not reuse __construct arg Stdlib: ceil, floor, intval and expanded PHPT specs #3 string)
• No new runtime/*.c

Repro

./script/docker-exec.sh -- bash -lc 'php test/repro/maintainer_gap_regexiterator_setmode_valueerror.php'
./script/docker-exec.sh -- bash -lc 'php bin/vm.php test/repro/maintainer_gap_regexiterator_setmode_valueerror.php'

Done when

• setMode(99) ValueError message matches Zend (RegexIterator::setMode(): Argument #1 ($mode) …)
• Targeted compliance/PHPUnit guard
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: Worker Lane C — starting this run

[PurHur]

Merged #31588

Fix: RegexIteratorBuiltin::validateMode() takes a caller citation; setModeValue uses RegexIterator::setMode(): Argument #1 ($mode) instead of the shared __construct Argument #3 string.

Verification

• Zend + php bin/vm.php on test/repro/maintainer_gap_regexiterator_setmode_valueerror.php both print Zend-shaped setMode arg Php stdlib specs implementation #1 ValueError
• ./script/phpunit.sh --filter 'Issue31573RegexIteratorSetModeValueErrorTest|RegexIteratorSetModeValueError31573VMTest' → OK (2 tests, 3 assertions)