Language: PHP 8.4 Range value object — Range::from() foreach (#17427)

[PurHur]

Summary

• Register Range as a PHP 8.4 forward-profile builtin class implementing IteratorAggregate.
• Range::from(1, 3) and Range::from('a', 'c') iterate inclusive int/string intervals via reused VmRange logic + ArrayIterator.
• class_exists('Range') remains false on the 8.2 reference profile; compliance + unit guards added.

php-src reference

• ext/standard/range.c — Range value object semantics (PHP 8.4 forward profile)

PHP implementation

• ext/standard/RangeBuiltin.php — VM registration, from() factory, getIterator() via VmRange + ArrayIteratorBuiltin
• lib/CompilerVersion.php — supportsRange() gated like other 8.4 builtins
• ext/standard/BuiltinClasses.php — profile-gated registration

Verification

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
export PHP_COMPILER_PROFILE=8.4
php bin/vm.php test/repro/maintainer_gap_range_from_84.php'
# ok

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
export PHP_COMPILER_PROFILE=8.4
vendor/bin/phpunit --filter RangeBuiltinTest'
# OK (1 test)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
export PHP_COMPILER_PROFILE=8.4
vendor/bin/phpunit --filter range_from_84 test/compliance/VMTest.php'
# OK (1 test)

env -u PHP_COMPILER_PROFILE php bin/vm.php -r "echo class_exists(\"Range\", false) ? \"fail\\n\" : \"ok\\n\";"
# ok (phantom gate)

php script/bootstrap-inventory.php --check
# OK 4283/4283

php script/check-selfhost-spine-coverage-sync.php
# OK

Closes #17427

Made with Cursor