Intl: Add IntlListFormatter class

Allows to format a list of item with
- TYPE_AND/TYPE_OR/TYPE_UNITS operands.
- WIDTH_WIDE, WIDTH_SHORT, WIDTH_NARROW.

close phpGH-18519

Author: BogdanUngureanu

NEWS

@@ -96,6 +96,8 @@ PHP                                                                        NEWS
   . Added grapheme_levenshtein() function. (Yuya Hamada)
   . Added Locale::addLikelySubtags/Locale::minimizeSubtags to handle
     adding/removing likely subtags to a locale. (David Carlier)
+  . Added IntlListFormatter class to format a list of items with a locale
+    , operands types and units. (BogdanUngureanu)
 
 - MySQLi:
   . Fixed bugs GH-17900 and GH-8084 (calling mysqli::__construct twice).

UPGRADING

@@ -180,6 +180,9 @@ PHP 8.5 UPGRADE NOTES
     number formats.
   . Added Locale::addLikelySubtags and Locale::minimizeSubtags to
     handle likely tags on a given locale.
+  . Added IntlListFormatter class to format, order, punctuates 
+    a list of items with a given locale, AND/OR and UNIT operands.
+    It is supported from icu 67.
 
 - XSL:
   . The $namespace argument of XSLTProcessor::getParameter(),
@@ -415,6 +418,12 @@ PHP 8.5 UPGRADE NOTES
 - Intl:
   . DECIMAL_COMPACT_SHORT.
   . DECIMAL_COMPACT_LONG.
+  . TYPE_AND.
+  . TYPE_OR.
+  . TYPE_UNITS.
+  . WIDTH_WIDE.
+  . WIDTH_SHORT.
+  . WIDTH_NARROW.
 
 - POSIX:
   . POSIX_SC_OPEN_MAX.

ext/intl/config.m4

@@ -39,6 +39,7 @@ if test "$PHP_INTL" != "no"; then
       locale/locale_class.c
       locale/locale_methods.c
       locale/locale.c
+      listformatter/listformatter_class.c
       msgformat/msgformat_attr.c
       msgformat/msgformat_class.c
       msgformat/msgformat_data.c
@@ -119,6 +120,7 @@ if test "$PHP_INTL" != "no"; then
     $ext_builddir/grapheme
     $ext_builddir/idn
     $ext_builddir/locale
+    $ext_builddir/listformatter
     $ext_builddir/msgformat
     $ext_builddir/normalizer
     $ext_builddir/resourcebundle

ext/intl/config.w32

@@ -39,6 +39,9 @@ if (PHP_INTL != "no") {
 				formatter_main.c \
 				formatter_parse.c \
 				", "intl");
+		ADD_SOURCES(configure_module_dirname + "/listformatter", "\
+				listformatter_class.c \
+				", "intl");
 		ADD_SOURCES(configure_module_dirname + "/locale", "\
 				locale.c \
 				locale_class.c \

ext/intl/listformatter/listformatter.stub.php

@@ -0,0 +1,40 @@
+<?php
+
+/** @generate-class-entries */
+
+/**
+ * @not-serializable
+ * @strict-properties
+ */
+final class IntlListFormatter {
+
+     /** @cvalue ULISTFMT_TYPE_AND */
+     public const int TYPE_AND = UNKNOWN;
+    
+#if U_ICU_VERSION_MAJOR_NUM >= 67
+    /** @cvalue ULISTFMT_TYPE_OR */
+    public const int TYPE_OR = UNKNOWN;
+
+    /** @cvalue ULISTFMT_TYPE_UNITS */
+    public const int TYPE_UNITS = UNKNOWN;
+#endif
+
+    /** @cvalue ULISTFMT_WIDTH_WIDE */
+    public const int WIDTH_WIDE = UNKNOWN;
+
+#if U_ICU_VERSION_MAJOR_NUM >= 67
+    /** @cvalue ULISTFMT_WIDTH_SHORT */
+    public const int WIDTH_SHORT = UNKNOWN;
+
+    /** @cvalue ULISTFMT_WIDTH_NARROW */
+    public const int WIDTH_NARROW = UNKNOWN;
+#endif
+
+    public function __construct(string $locale, int $type = IntlListFormatter::TYPE_AND, int $width = IntlListFormatter::WIDTH_WIDE) {}
+
+    public function format(array $strings): string|false {}
+
+    public function getErrorCode(): int {}
+
+    public function getErrorMessage(): string {}
+}