Sync EN: document FILTER_THROW_ON_FAILURE and Filter exception classes

[lacatoire]

Syncs the RU manual with upstream doc-en PR 5607 (PHP 8.5): documents the FILTER_THROW_ON_FAILURE constant and adds the two new Filter\FilterException / Filter\FilterFailedException class pages. EN-Revision bumped; maintainers kept on existing files, the two new files are translated.

Fixes #1480

[mmalferov]

Луи, я поздно обратил внимание на ваш запрос, уже после вливания #1484. Не сердитесь, пожалуйста 😉

И примите мое восхищение. Вы отлично справляетесь! Не стали переводить предложение:

Can be used with any validation FILTER_VALIDATE_* filter

Буквально:

Может использоваться с любым фильтром проверки FILTER_VALIDATE_*

Перевод в таком качестве выдаст и Гугл-переводчик, без участия человека.

Но написали:

Флаг указывают при проверке значений фильтрами семейства FILTER_VALIDATE_*

— никакого мусора, чисто, сухо, без воды, в активном залоге, каждое слово на своем месте 👍

То ли дело Может использоваться с любым фильтром проверки. Пропустим-ка формулировку через фильтры 🙂

• Кто (?!) может? Где подлежащее, кто актор?

• Может — мусор, модальная калька.

  • Флаг может → Флаг указывают
  • Функция может принимать int и float → Функция принимает два типа значений: int и float
  • Метод может выбросить исключение → При передаче недопустимого значения метод выбросит исключение

• Использоваться — бессмыслица, слово «использоваться» никогда не объясняет конкретный способ.

  • Функцию используют → Функцию вызывают
  • Константа используется → Константу указывают
  • Пример использования → Пример сортировки массива
  • При использовании модуля → При включении модуля в сборку

• Любым — часто преувеличение или лишнее слово, которое не добавляет смысла.

  • Передача любого целочисленного значения вызовет ошибку → Передача целочисленного значения вызовет ошибку
  • Функция совместима с любой константой семейства FILTER_VALIDATE_* → Функция совместима с константами семейства FILTER_VALIDATE_*
  • Переменной дают любое название → Переменную называют произвольно

Вот и получаем после просеивания: Может использоваться с любым фильтром проверки — осталось только два осмысленных полезных слова: а) фильтр и б) проверка. Осталось только собрать описание флага:

Флаг указывают при проверке значений фильтрами семейства `FILTER_VALIDATE_*

Спасибо!