Regression: CachingIterator::setFlags(null) TypeError — Zend E_DEPRECATED soft coerce (ext/spl/spl_iterators.c)

[PurHur]

Category

Regression: · php-src-strict · CachingIterator::setFlags null flags

Problem

CachingIterator::setFlags(null) soft-coerces on Zend with E_DEPRECATED for parameter #1 ($flags) and stores flags=0. VM throws TypeError: Argument #1 ($flags) must be of type int, null given.

Distinct from open #31679 (__construct null $flags missing deprecate) and closed #24252 / #31551 (flag bit ValueError / CALL_TOSTRING).

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

Repro	Zend 8.2+	VM (2026-08-17)
$c->setFlags(null) after FULL_CACHE construct	E_DEPRECATED … #1 ($flags) + flags=0	TypeError … $flags must be int

php-src reference

• php/php-src ext/spl/spl_iterators.c — zim_CachingIterator_setFlags
• php/php-src ext/spl/spl_iterators.stub.php — setFlags(int $flags): void

PHP implementation target

• ext/spl/CachingIteratorBuiltin.php — null $flags → Zend E_DEPRECATED then coerce to 0 (do not TypeError)
• No new runtime/*.c

Repro

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

Done when

• Null $flags emits E_DEPRECATED citing parameter #1 ($flags) (no TypeError)
• getFlags() is 0 after the call
• Targeted compliance/PHPUnit guard
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #31694, #31695, #31696); starting with #31694

[PurHur]

Merged via squash PR for #31694.

Fix: CachingIteratorSetFlags uses VmMath::parseZParamLongBuiltinArgForFrame (php-src Z_PARAM_LONG) so null soft-deprecates #1 ($flags) and stores 0.

Verification

• VM + JIT repro → E_DEPRECATED + flags=0 (matches Zend)
• Issue31694CachingIteratorSetFlagsNullTest OK (4)
• Sibling CachingIteratorMultiToStringFlags31551 OK

Next in batch: #31695