From 187f5fa127fe6a910dc188afb6c98fda0f011650 Mon Sep 17 00:00:00 2001
From: lly0414 <1027583915@qq.com>
Date: Wed, 30 Aug 2023 13:58:21 +0800
Subject: [PATCH 1/3] update: permission class comment

---
 src/Permission.php | 53 +++++++++++++++++++++++++++++-----------------
 1 file changed, 34 insertions(+), 19 deletions(-)

diff --git a/src/Permission.php b/src/Permission.php
index 7ef64fb..7f83c42 100644
--- a/src/Permission.php
+++ b/src/Permission.php
@@ -20,29 +20,44 @@
 /**
  * @see \Casbin\Enforcer
  * @mixin Enforcer
- * @method static enforce(mixed ...$rvals) 权限检查，输入参数通常是(sub, obj, act)
+ * @method static bool enforce(mixed ...$rvals) 权限检查，输入参数通常是(sub, obj, act)
  * @method static bool addPolicy(mixed ...$params) 当前策略添加授权规则
  * @method static bool addPolicies(mixed ...$params) 当前策略添加授权规则
  * @method static bool hasPolicy(mixed ...$params) 确定是否存在授权规则
  * @method static bool removePolicy(mixed ...$params) 当前策略移除授权规则
- * @method static getAllRoles() 获取所有角色
- * @method static getPolicy() 获取所有的角色的授权规则
- * @method static getRolesForUser(string $name, string ...$domain) 获取用户具有的角色
- * @method static getUsersForRole(string $name, string ...$domain) 获取具有角色的用户
- * @method static hasRoleForUser(string $name, string $role, string ...$domain) 确定用户是否具有角色
- * @method static addRoleForUser(string $user, string $role, string ...$domain) 给用户添加角色
- * @method static addPermissionForUser(string $user, string ...$permission) 赋予权限给某个用户或角色
- * @method static deleteRoleForUser(string $user, string $role, string $domain) 删除用户的角色
- * @method static deleteRolesForUser(string $user, string ...$domain) 删除某个用户的所有角色
- * @method static deleteRole(string $role) 删除单个角色
- * @method static deletePermission(string ...$permission) 删除权限
- * @method static deletePermissionForUser(string $name, string $permission) 删除用户或角色的权限。如果用户或角色没有权限则返回 false(不会受影响)。
- * @method static deletePermissionsForUser(string $name) 删除用户或角色的权限。如果用户或角色没有任何权限（也就是不受影响），则返回false。
- * @method static getPermissionsForUser(string $name) 获取用户或角色的所有权限
- * @method static hasPermissionForUser(string $user, string ...$permission) 决定某个用户是否拥有某个权限
- * @method static getImplicitRolesForUser(string $name, string ...$domain) 获取用户具有的隐式角色
- * @method static getImplicitPermissionsForUser(string $username, string ...$domain) 获取用户具有的隐式权限
- * @method static addFunction(string $name, \Closure $func) 添加一个自定义函数
+ * @method static array getAllRoles() 获取所有角色
+ * @method static array getPolicy() 获取所有的角色的授权规则
+ * @method static array getRolesForUser(string $name, string ...$domain) 获取用户具有的角色
+ * @method static array getUsersForRole(string $name, string ...$domain) 获取具有角色的用户
+ * @method static bool hasRoleForUser(string $name, string $role, string ...$domain) 确定用户是否具有角色
+ * @method static bool addRoleForUser(string $user, string $role, string ...$domain) 给用户添加角色
+ * @method static bool addRolesForUser(string $user, array $roles, string ...$domain)
+ * @method static bool addPermissionForUser(string $user, string ...$permission) 赋予权限给某个用户或角色
+ * @method static bool addPermissionsForUser() 赋予用户或角色多个权限。 如果用户或角色已经有一个权限，则返回 false (不会受影响)
+ * @method static bool deleteRoleForUser(string $user, string $role, string $domain) 删除用户的角色
+ * @method static bool deleteUser(string $user) 删除用户
+ * @method static bool deleteRolesForUser(string $user, string ...$domain) 删除某个用户的所有角色
+ * @method static bool deleteRole(string $role) 删除单个角色
+ * @method static bool deletePermission(string ...$permission) 删除权限
+ * @method static bool deletePermissionForUser(string $name, string $permission) 删除用户或角色的权限。如果用户或角色没有权限则返回 false(不会受影响)。
+ * @method static bool deletePermissionsForUser(string $name) 删除用户或角色的权限。如果用户或角色没有任何权限（也就是不受影响），则返回false。
+ * @method static array getPermissionsForUser(string $name) 获取用户或角色的所有权限
+ * @method static bool hasPermissionForUser(string $user, string ...$permission) 决定某个用户是否拥有某个权限
+ * @method static array getImplicitRolesForUser(string $name, string ...$domain) 获取用户具有的隐式角色
+ * @method static array getImplicitPermissionsForUser(string $username, string ...$domain) 获取用户具有的隐式权限
+ * @method static array getImplicitUsersForRole(string $name, string ...$domain) 获取具有隐式用户的角色
+ * @method static array getImplicitResourcesForUser(string $user, string ...$domain) 获取具有隐式资源的用户
+ * @method static array getImplicitUsersForPermission(string ...$permission) 获取隐式用户的权限
+ * @method static array getAllUsersByDomain(string $domain) 获取域中的所有用户
+ * @method static array getUsersForRoleInDomain(string $name, string $domain) 获取在域内具有传入角色的用户
+ * @method static array getRolesForUserInDomain(string $name, string $domain) 获取域中用户具有的所有角色
+ * @method static array getPermissionsForUserInDomain(string $name, string $domain) 获取域中用户具有的所有权限
+ * @method static bool addRoleForUserInDomain(string $user, string $role, string $domain) 给域中的用户添加角色
+ * @method static bool deleteRoleForUserInDomain(string $user, string $role, string $domain) 删除域中用户的角色
+ * @method static bool deleteRolesForUserInDomain(string $user, string $domain) 删除域中用户的所有角色
+ * @method static bool deleteAllUsersByDomain(string $domain) 删除域中的所有用户
+ * @method static bool deleteDomains(string ...$domain) 删除域
+ * @method static bool addFunction(string $name, \Closure $func) 添加一个自定义函数
  */
 class Permission
 {

From 90236ed97dfb14d1b077b8e87397c8e342a363d2 Mon Sep 17 00:00:00 2001
From: lly0414 <1027583915@qq.com>
Date: Wed, 30 Aug 2023 17:31:30 +0800
Subject: [PATCH 2/3] =?UTF-8?q?fix:=20addPermissionsForUser()=E6=96=B9?=
 =?UTF-8?q?=E6=B3=95=E6=B3=A8=E9=87=8A=E6=B7=BB=E5=8A=A0=E5=85=A5=E5=8F=82?=
 =?UTF-8?q?=E5=AE=9A=E4=B9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/Permission.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Permission.php b/src/Permission.php
index 7f83c42..dc2f312 100644
--- a/src/Permission.php
+++ b/src/Permission.php
@@ -33,7 +33,7 @@
  * @method static bool addRoleForUser(string $user, string $role, string ...$domain) 给用户添加角色
  * @method static bool addRolesForUser(string $user, array $roles, string ...$domain)
  * @method static bool addPermissionForUser(string $user, string ...$permission) 赋予权限给某个用户或角色
- * @method static bool addPermissionsForUser() 赋予用户或角色多个权限。 如果用户或角色已经有一个权限，则返回 false (不会受影响)
+ * @method static bool addPermissionsForUser(string $user, array ...$permissions) 赋予用户或角色多个权限。 如果用户或角色已经有一个权限，则返回 false (不会受影响)
  * @method static bool deleteRoleForUser(string $user, string $role, string $domain) 删除用户的角色
  * @method static bool deleteUser(string $user) 删除用户
  * @method static bool deleteRolesForUser(string $user, string ...$domain) 删除某个用户的所有角色

From 8dc9c98d5aa1e4a934ffb4c9b9e3f54d9ee1f1c9 Mon Sep 17 00:00:00 2001
From: lly0414 <1027583915@qq.com>
Date: Wed, 30 Aug 2023 17:41:59 +0800
Subject: [PATCH 3/3] =?UTF-8?q?update:=20=E6=B7=BB=E5=8A=A0=E6=9B=B4?=
 =?UTF-8?q?=E6=96=B0=E7=AD=96=E7=95=A5=E5=92=8C=E5=88=A0=E9=99=A4=E7=AD=96?=
 =?UTF-8?q?=E7=95=A5=E6=96=B9=E6=B3=95=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/Permission.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Permission.php b/src/Permission.php
index dc2f312..b708f52 100644
--- a/src/Permission.php
+++ b/src/Permission.php
@@ -27,6 +27,8 @@
  * @method static bool removePolicy(mixed ...$params) 当前策略移除授权规则
  * @method static array getAllRoles() 获取所有角色
  * @method static array getPolicy() 获取所有的角色的授权规则
+ * @method static bool updatePolicies(array $oldPolices, array $newPolicies) 更新策略
+ * @method static bool removePolicies(array $rules) 删除策略
  * @method static array getRolesForUser(string $name, string ...$domain) 获取用户具有的角色
  * @method static array getUsersForRole(string $name, string ...$domain) 获取具有角色的用户
  * @method static bool hasRoleForUser(string $name, string $role, string ...$domain) 确定用户是否具有角色