add Acls attributes

Author: jcheron

src/Ubiquity/attributes/AttributesEngine.php

@@ -139,5 +139,13 @@ public function is(string $key, object $annotation): bool {
 		}
 		return false;
 	}
+
+	public function registerAcls(): void {
+		\array_merge(self::$registry, [
+			'allow' => \Ubiquity\attributes\items\acl\Allow::class,
+			'resource' => \Ubiquity\attributes\items\acl\Resource::class,
+			'permission' => \Ubiquity\attributes\items\acl\Permission::class
+		]);
+	}
 }
 

src/Ubiquity/attributes/items/acl/Allow.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Ubiquity\attributes\items\acl;
+
+use Attribute;
+use Ubiquity\annotations\BaseAnnotationTrait;
+use Ubiquity\attributes\items\BaseAttribute;
+
+/**
+ * Attribute Allow.
+ * usages :
+ * - #[Allow("roleName")]
+ * - #[Allow(role: "roleName")]
+ * - #[Allow(role: "roleName",resource: "resourceName",permission: "permissionName")]
+ * - #[Allow("roleName","resourceName","permissionName")]
+ *
+ * @author jc
+ * @version 1.0.0
+ */
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
+class Allow extends BaseAttribute {
+	use BaseAnnotationTrait;
+
+	public string $role;
+
+	public ?string $permission;
+
+	public ?string $resource;
+
+	/**
+	 * Allow constructor.
+	 * @param string $role
+	 * @param string|null $resource
+	 * @param string|null $permission
+	 */
+	public function __construct(string $role, ?string $resource = null, ?string $permission = null) {
+		$this->role = $role;
+		$this->resource = $resource;
+		$this->permission = $permission;
+	}
+
+}

src/Ubiquity/attributes/items/acl/Permission.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace Ubiquity\attributes\items\acl;
+
+use Attribute;
+use Ubiquity\annotations\BaseAnnotationTrait;
+use Ubiquity\attributes\items\BaseAttribute;
+
+/**
+ * Attribute Permission.
+ * usages :
+ * - #[Permission("permissionName")]
+ * - #[Permission("permissionName",permissionLevel)]
+ * - #[Permission(name: "permissionName")]
+ * - #[Permission(name: "permissionName",level: permissionLevel)]
+ *
+ * @author jc
+ * @version 1.0.0
+ */
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
+class Permission extends BaseAttribute {
+	use BaseAnnotationTrait;
+
+	public string $name;
+
+	public ?int $level;
+
+	/**
+	 * Permission constructor.
+	 * @param string $name
+	 * @param int|null $level
+	 */
+	public function __construct(string $name, ?int $level = 0) {
+		$this->name = $name;
+		$this->level = $level;
+	}
+
+
+}

src/Ubiquity/attributes/items/acl/Resource.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Ubiquity\attributes\items\acl;
+
+
+use Attribute;
+use Ubiquity\annotations\BaseAnnotationTrait;
+use Ubiquity\attributes\items\BaseAttribute;
+
+/**
+ * Attribute Resource.
+ * usages :
+ * - #[Resource("resourceName")]
+ * - #[Resource(name: "resourceName")]
+ *
+ * @author jc
+ * @version 1.0.0
+ */
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
+class Resource extends BaseAttribute {
+	use BaseAnnotationTrait;
+
+	public string $name;
+
+	/**
+	 * Resource constructor.
+	 * @param string $name
+	 */
+	public function __construct(string $name) {
+		$this->name = $name;
+	}
+
+}

src/Ubiquity/attributes/items/router/Route.php

@@ -12,7 +12,7 @@
  * - #[Route("routePath")] default path: ""
  * - #[Route(path: "routePath")]
  * - #[Route("routePath",methods:["routeMethods"])]
- * - #[Route("routePath",cache: true,duration: intValue)]
+ * - #[Route("routePath",cache: true, duration: intValue)]
  * - #[Route("routePath",inherited: true)]
  * - #[Route("routePath",automated: true)]
  * - #[Route("routePath",requirements: ["member"=>"regExpr"])]
@@ -48,7 +48,7 @@ public function __construct(string $path = '', ?array $methods = null, ?string $
 
 	public function getPropertiesAndValues($props = null) {
 		$r = parent::getPropertiesAndValues($props);
-		if (is_subclass_of($this, Route::class)) {
+		if (\is_subclass_of($this, Route::class)) {
 			unset($r['methods']);
 		}
 		return $r;