ext/intl: PHP appears to under-expose `Spoofchecker` functionality on ICU 57.x

[LamentXU123]

Description

According to build/php.m4, PHP's ICU minimum is currently 57.1. And as per the ICU doc, ICU already provides the restriction-level API before ICU 57:

• uspoof_setRestrictionLevel() supported in ICU 51
  https://unicode-org.github.io/icu-docs/apidoc/dev/icu4c/uspoof_8h.html#a09c3e03f3260688f5932ad8fdd256ac7

• URestrictionLevel supported in ICU 51
  https://unicode-org.github.io/icu-docs/apidoc/dev/icu4c/uspoof_8h.html#a507e646ac472ea3866b59b0511720218

• USPOOF_MIXED_NUMBERS supported in ICU 51:
  https://unicode-org.github.io/icu-docs/apidoc/dev/icu4c/uspoof_8h.html#a0dbd60e53a571689baf65c63f4de8155a0fbfe4596de0672faf4f0d4f01a823f6

• ...

However, every above constants or functions could only be used under ICU >= 58 in php. There is a hard version guard against them, which means if someone build php under ICU 57.x (though it is really, really rare) the guy might have trouble dealing with those APIs in php interface since they are only valid under ICU >= 58.

the source of those is

  #if U_ICU_VERSION_MAJOR_NUM >= 58
      public const int ASCII = UNKNOWN;
      public const int HIGHLY_RESTRICTIVE = UNKNOWN;
      public const int MODERATELY_RESTRICTIVE = UNKNOWN;
      public const int MINIMALLY_RESTRICTIVE = UNKNOWN;
      public const int UNRESTRICTIVE = UNKNOWN;
      public const int SINGLE_SCRIPT_RESTRICTIVE = UNKNOWN;
      public const int MIXED_NUMBERS = UNKNOWN;
  #endif

  #if U_ICU_VERSION_MAJOR_NUM >= 58
      public function setRestrictionLevel(int $level): void {}
  #endif

There seems to be much more APIs that is supported in ICU 57.x which is clearly supported in php, and could only be used under ICU >= 58, across the intl code base. At this point I don't even sure if we actually care about ICU < 58

I don't sure if we should treat this as a new feature request or a bug report. cc @devnexen if you have enough time on this topic. Or I'd be happy to work on this in this weekend :)

PHP Version

all versions

Operating System

N/A

[devnexen]

correct analysis, just a caveat: not every >= 58 guard can go. in spoofchecker_main.cpp; isSuspicious, uspoof_check2UTF8 is genuinely @stable ICU 58 with
uspoof_checkUTF8 as the fallback; that branch plus uspoof_getCheckResultChecks and the co->uspoofres plumbing in spoofchecker_create.cpp / spoofchecker_class.h must
stay gated. only the constants block, setRestrictionLevel, and matching arginfo can be made unconditional. feel free to take it.

[Sgtp4py]

Résumé de la tâche

Le problème concerne l'extension intl de PHP qui limite l'accès à certaines fonctionnalités de la classe Spoofchecker aux versions ICU >= 58, alors que ces fonctionnalités sont en réalité disponibles dès ICU 51. Il s'agit donc d'un possible bug ou d'une amélioration à apporter pour permettre l'utilisation de ces API sur ICU 57.x, ce qui pourrait bénéficier aux utilisateurs ayant cette version d'ICU.

Estimation rapide de faisabilité

La tâche semble technique mais réalisable pour un développeur expérimenté en C et PHP, notamment avec une bonne connaissance de l'extension intl et de la gestion des versions ICU dans le code source PHP. Le travail consisterait à modifier les gardes conditionnels dans le code source pour étendre la compatibilité à ICU 57.x, puis tester la rétrocompatibilité.

Réponse / candidature prête à poster

Bonjour,

Je suis intéressé par la résolution de ce problème concernant la sous-exposition des fonctionnalités `Spoofchecker` sur ICU 57.x dans PHP. Ayant une expérience en développement C et extension PHP, je peux analyser et modifier les gardes conditionnels dans le code source pour permettre l'utilisation des API disponibles dès ICU 51, tout en assurant la stabilité et la compatibilité.

Avant de commencer, pourriez-vous me confirmer si ce travail est rémunéré ? Si oui, merci de me préciser les modalités.

Cordialement,
[Votre Prénom]

Question de paiement

Cette tâche nécessite un travail de développement et de tests non négligeable. Pouvez-vous me confirmer qu'il s'agit d'une mission rémunérée, et si oui, quel est le budget ou le mode de rémunération envisagé ?

---

Je reste à disposition pour toute précision complémentaire.