Stdlib: Locale::canonicalize()/parseLocale()/composeLocale()/getKeywords() missing after #6696/#20036 (ext/intl/locale)

[PurHur]

Category

stdlib · php-src-strict · ext/intl Locale · pillar 4

Problem

Locale is advertised after #6696 / #9576 / #20036 (getDefault, getDisplayName, lookup, filterMatches, acceptFromHttp, …), but the BCP-47 canonicalize/parse/compose/keywords surface from php-src is still missing. Call sites that do Locale::canonicalize() hit undefined-method fatals despite class_exists('Locale').

Repro	Zend (intl)	VM PROFILE=8.4 (2026-07-18)
method_exists(Locale::class, 'getDefault')	true	true
method_exists(..., 'lookup') / filterMatches / acceptFromHttp	true	true
method_exists(..., 'canonicalize')	true	false
method_exists(..., 'parseLocale')	true	false
method_exists(..., 'composeLocale')	true	false
method_exists(..., 'getKeywords')	true	false
Locale::canonicalize('en-US')	en_US (ICU form)	Error: Call to undefined static method

Also still missing (same stub; may ship in follow-ups): getAllVariants, getDisplayLanguage/Region/Script/Variant, getDisplayKeyword*, isRightToLeft, addLikelySubtags, minimizeSubtags.

php-src reference

• php/php-src ext/intl/locale/locale.stub.php — canonicalize / parseLocale / composeLocale / getKeywords
• php/php-src ext/intl/locale/locale_methods.c — locale_canonicalize / locale_parse / locale_compose / locale_get_keywords

PHP implementation target

• Extend ext/intl/VmLocale.php (+ method classes beside LocaleLookup / LocaleFilterMatches) — PHP-in-PHP using existing BCP-47 parser helpers; thin ICU FFI only if canonicalize needs uloc_canonicalize
• Register in Locale class registration path used by Stdlib: Locale class — getDefault()/getDisplayName() ICU locale API missing (ext/intl/locale) #6696/Stdlib: Locale::lookup()/locale_lookup() + acceptFromHttp — BCP-47 negotiate missing (ext/intl/locale) #20036

Repro

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && PHP_COMPILER_PROFILE=8.4 php bin/vm.php -r "
\$m=[\"canonicalize\",\"parseLocale\",\"composeLocale\",\"getKeywords\"];
foreach (\$m as \$n) echo \$n,\"=\",(method_exists(Locale::class,\$n)?\"1\":\"0\"),PHP_EOL;
try { var_export(Locale::canonicalize(\"en-US\")); echo PHP_EOL; }
catch (Throwable \$e) { echo get_class(\$e),\": \",\$e->getMessage(),PHP_EOL; }
"'

Done when

• canonicalize / parseLocale / composeLocale / getKeywords exist and match Zend/intl on a small BCP-47 fixture set (including @currency= keywords)
• Compliance .phpt under test/compliance/cases/intl/
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: PHP Compiler Ext — I/O & Crypto — starting this run (Locale canonicalize/parseLocale/composeLocale/getKeywords).

[PurHur]

Merged via #20750.

Verification:

• Issue repro PROFILE=8.4: canonicalize/parseLocale/composeLocale/getKeywords present; canonicalize('en-US') → en_US
• vendor/bin/phpunit --filter locale_canonicalize_parse → OK (2 tests, VM+JIT)
• inventory OK 5818/5818; check-generated-docs OK

php-src: ext/intl/locale/locale_methods.c — ICU uloc_* FFI + PHP fallbacks in ext/intl/VmLocale.php.