fix PHPDoc

spatie · May 26, 2023 · 6926349 · 6926349
1 parent 563794f
commit 6926349
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 1 deletion.
diff --git a/src/Models/Permission.php b/src/Models/Permission.php
@@ -34,6 +34,11 @@ public function __construct(array $attributes = [])
         $this->table = config('permission.table_names.permissions') ?: parent::getTable();
     }
 
+    /**
+     * @return PermissionContract|Permission
+     *
+     * @throws PermissionAlreadyExists
+     */
     public static function create(array $attributes = [])
     {
         $attributes['guard_name'] = $attributes['guard_name'] ?? Guard::getDefaultName(static::class);

diff --git a/src/Models/Role.php b/src/Models/Role.php
@@ -35,6 +35,11 @@ public function __construct(array $attributes = [])
         $this->table = config('permission.table_names.roles') ?: parent::getTable();
     }
 
+    /**
+     * @return RoleContract|Role
+     *
+     * @throws RoleAlreadyExists
+     */
     public static function create(array $attributes = [])
     {
         $attributes['guard_name'] = $attributes['guard_name'] ?? Guard::getDefaultName(static::class);
@@ -143,7 +148,10 @@ public static function findOrCreate(string $name, $guardName = null): RoleContra
         return $role;
     }
 
-    protected static function findByParam(array $params = [])
+    /**
+     * Finds a role based on an array of parameters.
+     */
+    protected static function findByParam(array $params = []): ?RoleContract
     {
         $query = static::query();