Regression: MultipleIterator::setFlags(null) E_DEPRECATED cites parameter #0 — Zend #1 ($flags) (ext/spl/spl_iterators.c)

[PurHur]

Category

Regression: · php-src-strict · SPL soft-null

Problem

MultipleIterator::setFlags(null) under non-strict types emits E_DEPRECATED and soft-coerces to 0, but the deprecation cites parameter #0 ($flags). Zend cites parameter #1. Sibling soft-null setters: RegexIterator (#31748), CachingIterator (#31694).

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

Repro	Zend 8.2+	VM (2026-08-17)
$m->setFlags(null) then getFlags()	E_DEPRECATED parameter #1 ($flags) + 0	E_DEPRECATED parameter #0 ($flags) + 0

php-src reference

• php/php-src ext/spl/spl_iterators.c — SPL_METHOD(MultipleIterator, setFlags) / Z_PARAM_LONG
• php/php-src ext/spl/spl_iterators.stub.php — setFlags(int $flags)

PHP implementation target

• ext/spl/MultipleIteratorBuiltin.php — MultipleIteratorSetFlags::execute uses parseIntBuiltinArg(..., 0, 'flags'); switch to VmMath::parseZParamLongBuiltinArgForFrame($frame, 1, 'MultipleIterator::setFlags', 1, 'flags') like CachingIterator (Regression: CachingIterator::setFlags(null) TypeError — Zend E_DEPRECATED soft coerce (ext/spl/spl_iterators.c) #31694); no new runtime/*.c

Repro

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

Done when

• setFlags(null) emits Zend-matching E_DEPRECATED citing parameter Php stdlib specs implementation #1 ($flags) then stores 0 on VM; JIT agrees
• Compliance .phpt guard under test/compliance/cases/ (SPL / MultipleIterator)
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #31795, #31796) after #31748 merged (#31794). Implementing MultipleIterator::setFlags(null) arg-index first.

[PurHur]

Merged via #31798 — VM DEP now cites parameter #1 ($flags) + flags=0; PHPUnit Issue31795 + focused VMTest OK.