Support parsing php 8.1 enum doc comments

Requires php/php-src#6984
(php 8.1 has no public alphas yet)

Author: TysonAndre

ast_data.c

@@ -658,7 +658,8 @@ zend_string *ast_kind_child_name(zend_ast_kind kind, uint32_t child) {
 			switch (child) {
 				case 0: return AST_STR(str_name);
 				case 1: return AST_STR(str_expr);
-				case 2: return AST_STR(str_attributes);
+				case 2: return AST_STR(str_docComment);
+				case 3: return AST_STR(str_attributes);
 			}
 			return NULL;
 		case ZEND_AST_METHOD_CALL:

scripts/generate_ast_data.php

@@ -134,7 +134,7 @@
     'ZEND_AST_MATCH' => ['cond', 'stmts'],
     'ZEND_AST_MATCH_ARM' => ['cond', 'expr'],
     'ZEND_AST_NAMED_ARG' => ['name', 'expr'],
-    'ZEND_AST_ENUM_CASE' => ['name', 'expr', 'attributes'],
+    'ZEND_AST_ENUM_CASE' => ['name', 'expr', 'docComment', 'attributes'],
 
     /* 3 child nodes */
     'ZEND_AST_METHOD_CALL' => ['expr', 'method', 'args'],

tests/php81_enums.phpt

@@ -16,6 +16,7 @@ enum HasValue: int {
 
 #[MyAttribute(1)]
 enum NoValue {
+    /** Case doc comment */
     #[OtherAttribute()]
     case FOO;
 }
@@ -39,6 +40,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: 42
+                docComment: null
                 attributes: null
             1: AST_CLASS_CONST_DECL
                 flags: MODIFIER_PUBLIC (%d)
@@ -61,6 +63,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: null
+                docComment: "/** Case doc comment */"
                 attributes: AST_ATTRIBUTE_LIST
                     0: AST_ATTRIBUTE_GROUP
                         0: AST_ATTRIBUTE
@@ -80,6 +83,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: 42
+                docComment: null
                 attributes: null
             1: AST_CLASS_CONST_GROUP
                 flags: MODIFIER_PUBLIC (%d)
@@ -106,6 +110,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: null
+                docComment: "/** Case doc comment */"
                 attributes: AST_ATTRIBUTE_LIST
                     0: AST_ATTRIBUTE_GROUP
                         0: AST_ATTRIBUTE
@@ -133,6 +138,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: 42
+                docComment: null
                 attributes: null
             1: AST_CLASS_CONST_GROUP
                 flags: MODIFIER_PUBLIC (%d)
@@ -161,6 +167,7 @@ AST_STMT_LIST
             0: AST_ENUM_CASE
                 name: "FOO"
                 expr: null
+                docComment: "/** Case doc comment */"
                 attributes: AST_ATTRIBUTE_LIST
                     0: AST_ATTRIBUTE_GROUP
                         0: AST_ATTRIBUTE