Implement Attribute Amendments.

RFC: https://wiki.php.net/rfc/attribute_amendments

Support for attribute grouping is left out, because the short
attribute syntax RFC will likely make it obsolete.

Closes GH-5751.

Author: kooldev

UPGRADING

@@ -554,6 +554,7 @@ PHP 8.0 UPGRADE NOTES
     RFC: https://wiki.php.net/rfc/mixed_type_v2
   . Added support for Attributes
     RFC: https://wiki.php.net/rfc/attributes_v2
+    RFC: https://wiki.php.net/rfc/attribute_amendments
   . Added support for constructor property promotion (declaring properties in
     the constructor signature).
     RFC: https://wiki.php.net/rfc/constructor_promotion

Zend/tests/attributes/002_rfcexample.phpt

@@ -4,9 +4,9 @@ Attributes: Example from Attributes RFC
 <?php
 // https://wiki.php.net/rfc/attributes_v2#attribute_syntax
 namespace My\Attributes {
-    use PhpAttribute;
+    use Attribute;
 
-    <<PhpAttribute>>
+    <<Attribute>>
     class SingleArgument {
         public $argumentValue;
 
@@ -37,7 +37,7 @@ array(1) {
   [0]=>
   string(11) "Hello World"
 }
-object(My\Attributes\SingleArgument)#3 (1) {
+object(My\Attributes\SingleArgument)#%d (1) {
   ["argumentValue"]=>
   string(11) "Hello World"
 }

Zend/tests/attributes/003_ast_nodes.phpt

@@ -59,7 +59,7 @@ var_dump($ref->getAttributes()[0]->getArguments());
 
 echo "\n";
 
-<<PhpAttribute>>
+<<Attribute>>
 class C5
 {
 	public function __construct() { }

Zend/tests/attributes/005_objects.phpt

@@ -3,7 +3,7 @@ Attributes can be converted into objects.
 --FILE--
 <?php
 
-<<PhpAttribute>>
+<<Attribute(Attribute::TARGET_FUNCTION)>>
 class A1
 {
 	public string $name;
@@ -56,7 +56,7 @@ try {
 
 echo "\n";
 
-<<PhpAttribute>>
+<<Attribute>>
 class A3
 {
 	private function __construct() { }
@@ -72,7 +72,7 @@ try {
 
 echo "\n";
 
-<<PhpAttribute>>
+<<Attribute>>
 class A4 { }
 
 $ref = new \ReflectionFunction(<<A4(1)>> function () { });
@@ -117,4 +117,4 @@ string(7) "ERROR 5"
 string(71) "Attribute class 'A4' does not have a constructor, cannot pass arguments"
 
 string(7) "ERROR 6"
-string(78) "Attempting to use class 'A5' as attribute that does not have <<PhpAttribute>>."
+string(55) "Attempting to use non-attribute class 'A5' as attribute"

Zend/tests/attributes/007_self_reflect_attribute.phpt

@@ -1,19 +1,22 @@
 --TEST--
-Attributes: attributes on PhpAttribute return itself
+Attributes: attributes on Attribute return itself
 --FILE--
 <?php
 
-$reflection = new \ReflectionClass(PhpAttribute::class);
+$reflection = new \ReflectionClass(Attribute::class);
 $attributes = $reflection->getAttributes();
 
 foreach ($attributes as $attribute) {
     var_dump($attribute->getName());
     var_dump($attribute->getArguments());
-    var_dump($attribute->newInstance());
+
+    $a = $attribute->newInstance();
+    var_dump(get_class($a));
+    var_dump($a->flags == Attribute::TARGET_ALL);
 }
 --EXPECTF--
-string(12) "PhpAttribute"
+string(9) "Attribute"
 array(0) {
 }
-object(PhpAttribute)#3 (0) {
-}
+string(9) "Attribute"
+bool(true)

Zend/tests/attributes/008_wrong_attribution.phpt

@@ -1,9 +1,9 @@
 --TEST--
-Attributes: Prevent PhpAttribute on non classes
+Attributes: Prevent Attribute on non classes
 --FILE--
 <?php
 
-<<PhpAttribute>>
+<<Attribute>>
 function foo() {}
 --EXPECTF--
-Fatal error: Only classes can be marked with <<PhpAttribute>> in %s
+Fatal error: Attribute "Attribute" cannot target function (allowed targets: class) in %s

Zend/tests/attributes/018_variable_attribute_name.phpt renamed to Zend/tests/attributes/019_variable_attribute_name.phpt

@@ -0,0 +1,70 @@
+--TEST--
+Attributes expose and verify target and repeatable data.
+--FILE--
+<?php
+
+<<Attribute(Attribute::TARGET_FUNCTION | Attribute::TARGET_METHOD)>>
+class A1 { }
+
+$ref = new \ReflectionFunction(<<A1>> function () { });
+$attr = $ref->getAttributes()[0];
+var_dump($attr->getName(), $attr->getTarget() == Attribute::TARGET_FUNCTION, $attr->isRepeated());
+var_dump(get_class($attr->newInstance()));
+
+echo "\n";
+
+$ref = new \ReflectionObject(new <<A1>> class() { });
+$attr = $ref->getAttributes()[0];
+var_dump($attr->getName(), $attr->getTarget() == Attribute::TARGET_CLASS, $attr->isRepeated());
+
+try {
+	$attr->newInstance();
+} catch (\Throwable $e) {
+	var_dump('ERROR 1', $e->getMessage());
+}
+
+echo "\n";
+
+$ref = new \ReflectionFunction(<<A1>> <<A1>> function () { });
+$attr = $ref->getAttributes()[0];
+var_dump($attr->getName(), $attr->getTarget() == Attribute::TARGET_FUNCTION, $attr->isRepeated());
+
+try {
+	$attr->newInstance();
+} catch (\Throwable $e) {
+	var_dump('ERROR 2', $e->getMessage());
+}
+
+echo "\n";
+
+<<Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)>>
+class A2 { }
+
+$ref = new \ReflectionObject(new <<A2>> <<A2>> class() { });
+$attr = $ref->getAttributes()[0];
+var_dump($attr->getName(), $attr->getTarget() == Attribute::TARGET_CLASS, $attr->isRepeated());
+var_dump(get_class($attr->newInstance()));
+
+?>
+--EXPECT--
+string(2) "A1"
+bool(true)
+bool(false)
+string(2) "A1"
+
+string(2) "A1"
+bool(true)
+bool(false)
+string(7) "ERROR 1"
+string(70) "Attribute "A1" cannot target class (allowed targets: function, method)"
+
+string(2) "A1"
+bool(true)
+bool(true)
+string(7) "ERROR 2"
+string(35) "Attribute "A1" must not be repeated"
+
+string(2) "A2"
+bool(true)
+bool(true)
+string(2) "A2"

Zend/tests/attributes/020_userland_attribute_validation.phpt

@@ -0,0 +1,11 @@
+--TEST--
+Attribute flags type is validated.
+--FILE--
+<?php
+
+<<Attribute("foo")>>
+class A1 { }
+
+?>
+--EXPECTF--
+Fatal error: Attribute::__construct(): Argument #1 ($flags) must must be of type int, string given in %s

Zend/tests/attributes/021_attribute_flags_type_is_validated.phpt

@@ -0,0 +1,11 @@
+--TEST--
+Attribute flags value is validated.
+--FILE--
+<?php
+
+<<Attribute(-1)>>
+class A1 { }
+
+?>
+--EXPECTF--
+Fatal error: Invalid attribute flags specified in %s

Zend/tests/attributes/022_attribute_flags_value_is_validated.phpt

@@ -0,0 +1,11 @@
+--TEST--
+Attribute flags value is validated.
+--FILE--
+<?php
+
+<<Attribute(Foo::BAR)>>
+class A1 { }
+
+?>
+--EXPECTF--
+Fatal error: Class 'Foo' not found in %s

Zend/tests/attributes/023_ast_node_in_validation.phpt

@@ -0,0 +1,11 @@
+--TEST--
+Internal attribute targets are validated.
+--FILE--
+<?php
+
+<<Attribute>>
+function a1() { }
+
+?>
+--EXPECTF--
+Fatal error: Attribute "Attribute" cannot target function (allowed targets: class) in %s

Zend/tests/attributes/024_internal_target_validation.phpt

@@ -0,0 +1,12 @@
+--TEST--
+Internal attribute targets are validated.
+--FILE--
+<?php
+
+<<Attribute>>
+<<Attribute>>
+class A1 { }
+
+?>
+--EXPECTF--
+Fatal error: Attribute "Attribute" must not be repeated in %s