Stdlib: IntlCalendar / IntlTimeZone — ext/intl calendar OOP missing (ext/intl/calendar)

[PurHur]

Category

stdlib

Problem

Zend ext/intl exposes IntlCalendar and IntlTimeZone for locale-aware calendar math (field get/set, roll, add, timezone rules). This compiler has an ext/intl skeleton (#5925, #5747, #5201) but no calendar classes — class_exists('IntlCalendar') and class_exists('IntlTimeZone') are false under bin/vm.php.

Scheduling, i18n date pickers, and ICU-based calendar conversions depend on this API (distinct from procedural date() / DateTime in #3072).

php-src reference

• php/php-src ext/intl/calendar/calendar_class.c — IntlCalendar methods
• php/php-src ext/intl/timezone/timezone_class.c — IntlTimeZone
• php/php-src ext/intl/calendar/calendar_methods.c — createInstance, get, set, add, roll
• php/php-src ext/intl/php_intl.stub.php — stubs

Repro (failure today)

<?php
var_export(class_exists('IntlCalendar'));
echo "\n";
var_export(class_exists('IntlTimeZone'));
echo "\n";
$cal = IntlCalendar::createInstance(null, 'en_US');
echo $cal->get(IntlCalendar::FIELD_YEAR), "\n";

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php repro_intl_calendar.php    # false/false if ext/intl absent in image; true + year if built
php bin/vm.php repro_intl_calendar.php
'

Runtime	class_exists('IntlCalendar')	createInstance
Zend (ext/intl)	true	object + field year
VM today	false	compile/runtime fatal — class unknown

Scope (this repo) — v1 subset

Module	Path
Extension	ext/intl/IntlCalendar.php, IntlTimeZone.php, Module.php registration
VM OOP	thin wrappers; v1 may delegate field math to host ICU behind VmIntl guard or port minimal Gregorian rules in PHP
Constants	IntlCalendar::FIELD_*, DOW_*, MONTH_*
Tests	test/compliance/cases/ext/intl_calendar_basic.phpt
Matrix	script/capability-matrix.php

Defer IntlGregorianCalendar, IntlBreakIterator integration, and full ICU timezone rule DB to phase 2. Coordinate with #3336 umbrella and #5201 date formatter.

PHP-in-PHP: prefer PHP class implementations in ext/intl/; no permanent C calendar tables in runtime/.

Done when

• IntlCalendar + IntlTimeZone registered; class_exists true on VM
• v1: createInstance, get/set on FIELD_YEAR/FIELD_MONTH/FIELD_DAY_OF_MONTH, getTimeZone — repro prints sensible year
• Compliance PHPT documents ICU/host dependency if v1 delegates
• ./script/ci-fast.sh --filter IntlCalendar green (or @group intl skip documented)

Links

• Stdlib: ext/intl — IntlDateFormatter / NumberFormatter / locale formatting (ext/intl parity) #3336 intl umbrella · Stdlib: ext/intl — IntlDateFormatter create/format (ext/intl/dateformat) #5201 IntlDateFormatter · Stdlib: ext/intl Collator — collator_create/compare/asort (ext/intl/collator) #5747 Collator · Bootstrap: ext/intl skeleton — Collator/IntlDateFormatter static methods must Error until #5747/#5201 #5925 skeleton · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #6151, #5154, #5201, #3336) — starting #6151 IntlCalendar/IntlTimeZone

[PurHur]

Merged — PR #19609

Merged: #19609

Verification

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php test/repro/issue_6151_intl_calendar.php'
# true / true / 2020 / UTC

vendor/bin/phpunit --filter 'intlcalendar_timezone_basic|IntlExtensionPolicyTest'
# OK (6 tests, 61 assertions)

php script/bootstrap-inventory.php --check  # 5170/5170
php script/check-selfhost-spine-coverage-sync.php  # OK
./script/spine-sync.sh --footnotes-only  # wave3 + sidecar OK

PHP-in-PHP Gregorian subset: IntlCalendar::createInstance/get/set/getTimeZone/getTime/setTime + IntlTimeZone::createTimeZone/createDefault/getID without extension_loaded('intl').

Batch next: #5154 NumberFormatter (after pull master).