Add ReflectionClassConstant::isDeprecated() (#14086)

This is in preparation for #11293 and for consistency with
ReflectionConstant::isDeprecated() that was added in #13669.

Author: TimWolla

UPGRADING

@@ -263,6 +263,7 @@ PHP 8.4 UPGRADE NOTES
   . ReflectionClassConstant::__toString() and ReflectionProperty::__toString()
     now returns the attached doc comments.
   . ReflectionConstant was introduced.
+  . ReflectionClassConstant::isDeprecated() was introduced.
 
 - Standard:
   . stream_bucket_make_writeable() and stream_bucket_new() will now return a

ext/reflection/php_reflection.c

@@ -4067,6 +4067,20 @@ ZEND_METHOD(ReflectionClassConstant, isEnumCase)
 	RETURN_BOOL(ZEND_CLASS_CONST_FLAGS(ref) & ZEND_CLASS_CONST_IS_CASE);
 }
 
+ZEND_METHOD(ReflectionClassConstant, isDeprecated)
+{
+	reflection_object *intern;
+	zend_constant *ref;
+
+	if (zend_parse_parameters_none() == FAILURE) {
+		RETURN_THROWS();
+	}
+
+	GET_REFLECTION_OBJECT_PTR(ref);
+
+	RETURN_BOOL(ZEND_CLASS_CONST_FLAGS(ref) & ZEND_ACC_DEPRECATED);
+}
+
 /* {{{ reflection_class_object_ctor */
 static void reflection_class_object_ctor(INTERNAL_FUNCTION_PARAMETERS, int is_object)
 {

ext/reflection/php_reflection.stub.php

@@ -554,6 +554,8 @@ public function getAttributes(?string $name = null, int $flags = 0): array {}
 
     public function isEnumCase(): bool {}
 
+    public function isDeprecated(): bool {}
+
     public function hasType(): bool {}
 
     public function getType(): ?ReflectionType {}

ext/reflection/php_reflection_arginfo.h

@@ -38,6 +38,11 @@ class _ZendTestClass implements _ZendTestInterface {
          */
         public const int|string TYPED_CLASS_CONST3 = UNKNOWN;
 
+        /**
+         * @deprecated
+         */
+        public const int ZEND_TEST_DEPRECATED = 42;
+
         /** @var mixed */
         public static $_StaticProp;
         public static int $staticIntProp = 123;

ext/zend_test/test.stub.php

@@ -0,0 +1,17 @@
+--TEST--
+ReflectionClassConstant::isDeprecated()
+--EXTENSIONS--
+zend_test
+--FILE--
+<?php
+
+$r = new ReflectionClassConstant('_ZendTestClass', 'ZEND_TEST_DEPRECATED');
+var_dump($r->isDeprecated());
+
+$r = new ReflectionClassConstant('_ZendTestClass', 'TYPED_CLASS_CONST2');
+var_dump($r->isDeprecated());
+
+?>
+--EXPECTF--
+bool(true)
+bool(false)