Stdlib JIT: iterator_to_array() LLVM lowering (phase 2 of #3100)

[PurHur]

Category

stdlib / JIT

Problem

iterator_to_array() is VM-only (#3100 closed). ext/standard/iterator_to_array.php throws in call() for JIT. Generators and Traversable materialization are needed in JIT/AOT paths that call this builtin (e.g. spread/collection helpers).

Capability matrix: VM yes, JIT no, AOT no.

php-src reference

• php/php-src ext/spl/iterator.c — PHP_FUNCTION(iterator_to_array)
• Generator iteration: php/php-src Zend/zend_generators.c

Repro

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/jit.php -r "function gen() { yield 1; yield 2; } echo count(iterator_to_array(gen()));"'

Today: JIT failure (VM-only call() stub).

Zend: 2

VM repro (works today):

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php -r "function gen() { yield 1; yield 2; } echo count(iterator_to_array(gen()));"'

Scope (this repo)

Area	Path
VM (done)	ext/standard/iterator_to_array.php
JIT	Lower to generator walk or call VM helper until #3074 generator JIT lands
AOT	Same; register in self-host builtin policy
Tests	test/compliance/cases/stdlib/iterator_to_array_jit.phpt
Matrix	capability-matrix.php

Done when

• JIT repro prints 2 for simple generator
• preserve_keys flag honored for keyed yields (feat(generators): SSOT VM-fallback, keyed-yield fix, JIT stub (#167) #3085 VM behavior)
• Matrix JIT/AOT yes for iterator_to_array

Notes

• Depends on generator semantics (Language: Generators (yield and yield from) #167, Language: Generator JIT lowering (yield opcodes) #3074) for full parity; v1 may delegate to runtime helper from JIT IR.
• Unblocks JIT code that materializes iterators without VM fallback.

Labels

stdlib, implementation-ready

[PurHur]

claim: runforge-worker-lane-c — starting this run (JIT lowering; VM done in #3100)

[PurHur]

Merged via PR #3912.

Verification:

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter iterator_to_array'
# OK (4 tests, 4 assertions) — VM + JIT PHPT

JIT lowering covers generators (resume walk) and arrays (preserve_keys compile-time bool). bin/jit.php -r MCJIT execute still segfaults in harness (pre-existing); compliance JIT path matches Zend for issue repro.

php-src: ext/spl/iterator.c — PHP_FUNCTION(iterator_to_array)