From ea714a31f8eb3343ee8db68ec9b699733c0bdc26 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Tue, 11 Aug 2026 20:59:29 +0300 Subject: [PATCH 1/2] Update new-classes.xml --- appendices/migration85/new-classes.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/appendices/migration85/new-classes.xml b/appendices/migration85/new-classes.xml index 82d0b4e80c..df1dc00062 100644 --- a/appendices/migration85/new-classes.xml +++ b/appendices/migration85/new-classes.xml @@ -1,5 +1,5 @@ - + Новые классы, перечисления и интерфейсы @@ -27,6 +27,13 @@ + + Intl + + IntlListFormatter + + + Модуль URI From f362ebb491c8494f3d14ebbc292273d176c9246c Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Thu, 13 Aug 2026 18:04:21 +0300 Subject: [PATCH 2/2] Update book.xml --- reference/intl/book.xml | 92 ++++++++++++++++++++--------------------- 1 file changed, 45 insertions(+), 47 deletions(-) diff --git a/reference/intl/book.xml b/reference/intl/book.xml index b16b011a21..88aae82df3 100644 --- a/reference/intl/book.xml +++ b/reference/intl/book.xml @@ -1,5 +1,5 @@ - + @@ -9,86 +9,83 @@ &reftitle.intro; - - Модуль интернационализации (далее Intl) - это обёртка для библиотеки - ICU, позволяющая программистам на PHP - производить различные операции, которые зависят от локали, например, - форматирование, транслитерация, преобразование кодировок, операции с календарём, - совместимое с UCA - сравнение, определение - границ текста и работать с идентификаторами локалей, часовыми поясами - и графемами. - - - Программный интерфейс модуля разрабатывается так, чтобы как можно точнее повторять - API ICU, чтобы люди, работавшие с ICE в C/C++ или Java, могли легко использовать API PHP. - Также благодаря этому документация ICE может быть полезной чтобы понять различие функции ICU. - + + Модуль интернационализации (далее — Intl) — обёртка над библиотекой + ICU. Компоненты модуля Intl открывают PHP-программистам + доступ к форматированию, транслитерации, преобразованию кодировок, операциям с календарём, + совместимому с алгоритмом UCA + сопоставлению, определению границ текста, + работе с идентификаторами локалей, часовыми поясами, графемами и к другим операциям, + которые модуль выполняет с учётом языковых и региональных стандартов. + - - Intl состоит из нескольких модулей, каждый из которых предоставляет соответствующий API ICU: - + + Сходство API модуля Intl и библиотеки ICU + помогает применять навык работы с функциями библиотеки в языках C/C++ или Java и при работе с API библиотеки ICU в PHP + и делает документацию к библиотеке ICU полезной для понимания закулисной работы функций PHP-модуля. + + + + Каждый компонент PHP-модуля Intl раскрывает API к конкретному модулю библиотеки API: + - Модуль сравнения: предоставляет инструменты для сравнения строк - с поддержкой соответствующего локали порядка сортировки. + Модуль сопоставления: инструмент сравнения строк + с учётом языковых и региональных правил сортировки. - Модуль форматирования чисел: позволяет отображать числа в соответствии с - правилами локали, или заданным шаблоном или с набором правил. - Также позволяет правильно разбирать строки в числа. + Модуль форматирования чисел: форматирует числа + с учётом локали, по шаблону или набору правил; + разбирает строки с числами. - Модуль форматирования сообщений: позволяет создавать сообщения, включающие - данные (такие как числа и даты), отформатированные в соответствии с - заданными шаблоном и локальными правилами, и, также, разбирать - сообщения, извлекая из них данные. + Модуль форматирования сообщений: создаёт сообщение по шаблону + и форматирует числа, даты или другие данные в шаблоне по правилам языкового и регионального стандарта; + разбирает сообщения для извлечения данных. + При формировании сообщения поддерживаются: множественное число, числа с учётом локали, валюты, условные конструкции и другие подстановки. - Модуль нормализации: предоставляет функции для преобразования текста - в одну из нормализованных форм Unicode. Также предоставляет возможность - проверить, является ли предоставленный текст уже нормализованным. + Модуль нормализации: приводит текст к нормализованным формам, которые определяет стандарт Юникод. + Проверяет, соответствует ли строка конкретной форме нормализации. - Модуль локали: предоставляет взаимодействие с идентификаторами - локали как к функциями, позволяя получить вложенные теги локали; - разбор, композиция, сравнение (поиск и фильтрация) идентификаторов локали. + Модуль локали: разбирает на подтеги, собирает, находит по приоритету и фильтрует идентификаторы локалей. - Модуль календаря: предоставляет класс, полезный для проведения зависимых - от локали операций с календарём, получения различной информации, такой как - часовые пояса для выбранной локали, первый день недели или - режим текущего зимнего/летнего времени. + Модуль календаря: класс, который выполняет операции с календарём + с учётом локали: + получает сведения о часовом поясе, первом дне недели + или текущем режиме летнего времени. - Модуль часового пояса: предоставляет обёртку над базой данных часовых поясов, - в которой содержится исчерпывающая информация о всех мировых часовых поясах. + Модуль часового пояса: обёртка над базой данных IANA, + которая содержит сведения о часовых поясах мира. - Модуль форматирования даты: позволяет отображать дату в соответствии с - принятым для данной локали форматом либо заданным шаблоном или набором правил. - Также нужен для разбора строк, содержащих описание даты и времени. + Модуль форматирования даты: форматирует дату и время + по правилам языкового и регионального стандарта, по шаблону или набору правил; + разбирает строки с датой и временем. - Модуль транслитерации: позволяет получить представление строки на различных языках в латинице. + Модуль транслитерации: преобразовывает строки на национальных, региональных и других языках в латинское представление. @@ -98,13 +95,13 @@ Ссылки - Различная документация ICU + Документация к библиотеке ICU - Руководство пользователя ICU + Руководство пользователя ICU - Алгоритм сопоставления Unicode + Алгоритм сопоставления в Юникоде @@ -133,6 +130,7 @@ &reference.intl.intlrulebasedbreakiterator; &reference.intl.intlcodepointbreakiterator; &reference.intl.intldatepatterngenerator; + &reference.intl.intllistformatter; &reference.intl.intlpartsiterator; &reference.intl.uconverter;