ext/intl: Add Spoofchecker::getRestrictionLevel()

NEWS

@@ -25,6 +25,7 @@ PHP                                                                        NEWS
     throwing a ValueError. (Marc Bennewitz)
 
 - Intl:
+  . Added Spoofchecker::getRestrictionLevel(). (Weilin Du)
   . Added Collator::getRules() and collator_get_rules(). (Weilin Du)
   . Added IntlRelativeDateTimeFormatter for locale-aware relative date and time
     formatting, with enums for styles, capitalization contexts, and units.

UPGRADING

@@ -129,6 +129,8 @@ PHP 8.7 UPGRADE NOTES
     to the root collation order; the full root/UCA rules are not included. An
     empty string is returned if no tailoring rules are available, or false if
     the rules cannot be converted to UTF-8.
+  . Added Spoofchecker::getRestrictionLevel() to retrieve the configured
+    restriction level as one of the Spoofchecker restriction level constants.
 
 ========================================
 7. New Classes and Interfaces

ext/intl/spoofchecker/spoofchecker.stub.php

@@ -78,6 +78,9 @@ public function setChecks(int $checks): void {}
 
     /** @tentative-return-type */
     public function setRestrictionLevel(int $level): void {}
+
+    public function getRestrictionLevel(): int {}
+
     public function setAllowedChars(string $pattern, int $patternOptions = 0): void {}
 
     public function getSkeleton(string $string): string|false {}

ext/intl/spoofchecker/spoofchecker_main.cpp

@@ -166,6 +166,19 @@ PHP_METHOD(Spoofchecker, setRestrictionLevel)
 }
 /* }}} */
 
+/* {{{ Get the configured restriction level. */
+PHP_METHOD(Spoofchecker, getRestrictionLevel)
+{
+	SPOOFCHECKER_METHOD_INIT_VARS;
+
+	ZEND_PARSE_PARAMETERS_NONE();
+
+	SPOOFCHECKER_METHOD_FETCH_OBJECT;
+
+	RETURN_LONG(uspoof_getRestrictionLevel(co->uspoof));
+}
+/* }}} */
+
 PHP_METHOD(Spoofchecker, setAllowedChars)
 {
 	zend_string *pattern;

ext/intl/tests/spoofchecker_get_restriction_level.phpt

@@ -0,0 +1,35 @@
+--TEST--
+Spoofchecker::getRestrictionLevel() returns the configured restriction level
+--EXTENSIONS--
+intl
+--FILE--
+<?php
+$checker = new Spoofchecker();
+var_dump($checker->getRestrictionLevel() === Spoofchecker::HIGHLY_RESTRICTIVE);
+
+foreach ([
+    Spoofchecker::ASCII,
+    Spoofchecker::SINGLE_SCRIPT_RESTRICTIVE,
+    Spoofchecker::HIGHLY_RESTRICTIVE,
+    Spoofchecker::MODERATELY_RESTRICTIVE,
+    Spoofchecker::MINIMALLY_RESTRICTIVE,
+    Spoofchecker::UNRESTRICTIVE,
+] as $level) {
+    $checker->setRestrictionLevel($level);
+    var_dump($checker->getRestrictionLevel() === $level);
+}
+
+// Disabling checks does not change the configured restriction level.
+$checker->setRestrictionLevel(Spoofchecker::ASCII);
+$checker->setChecks(0);
+var_dump($checker->getRestrictionLevel() === Spoofchecker::ASCII);
+?>
+--EXPECT--
+bool(true)
+bool(true)
+bool(true)
+bool(true)
+bool(true)
+bool(true)
+bool(true)
+bool(true)

ext/intl/tests/spoofchecker_get_restriction_level_unconstructed.phpt

@@ -0,0 +1,18 @@
+--TEST--
+Spoofchecker::getRestrictionLevel() rejects an unconstructed object
+--EXTENSIONS--
+intl
+--FILE--
+<?php
+$checker = new class extends Spoofchecker {
+    public function __construct() {}
+};
+
+try {
+    $checker->getRestrictionLevel();
+} catch (Error $e) {
+    echo $e->getMessage(), "\n";
+}
+?>
+--EXPECT--
+Found unconstructed Spoofchecker