⚡️ #yiisoftRbac #yiisoftRbacPhp

Продолжается подготовка RBAC к релизу.

• В абстрактном классе \Yiisoft\Rbac\Rule имя правила в конструкторе сделали опциональным: если его не передали, то в качестве имени правила будет использоваться имя класса (PR).

• Для правил добавили новый интерфейс RuleInterface, теперь правила реализуют его, а не ItemInterface (PR) и адаптировали к этому изменению Yii RBAC PHP File Storage (PR).

• Из Yii RBAC удалили класс DenyAll (PR), а точнее перенесли его ранее в Yii Access.

• Улучшили аннотации psalm в Yii RBAC (PR) и Yii RBAC PHP File Storage (PR).

⚡️ #yiisoftRbac

Удалили интерфейс ItemInterface в пакете Yii Role-Based Access Control, теперь абстрактный класс Item, от которого наследуются роли и разрешения, сам по себе и не реализует никакие интерфейсы (PR).

⚡️ #yiisoftRbac #yiisoftRbacPhp

Продолжаем готовить RBAC к релизу.

• В пакете Yii RBAC в фабрике для создания правил ClassNameRuleFactory добавили валидацию передаваемого имени класса и создаваемого правила, в случае ошибки бросается исключение RuntimeException с соответствующим сообщением (PR).

• Перенесли Yiisoft\Rbac\RuleFactory\ClassNameRuleFactory в Yiisoft\Rbac\ClassNameRuleFactory, переименовали метод Manager::setGuestRole() в Manager::setGuestRoleName(), причесали служебные файлы и увеличили покрытие тестами до 100% в пакете Yii RBAC (PR).

• Переименовали методы в классе \Yiisoft\Rbac\Manager (PR):
setDefaultRoles() → setDefaultRoleNames()
getDefaultRoles() → getDefaultRoleNames()
getDefaultRoleInstances() → getDefaultRoles()

• В пакете Yii RBAC PHP File Storage адаптировали код к последним изменениям в Yii RBAC, причесали служебные файлы и увеличили покрытие тестами (PR, PR, PR).

⚡️ #yiisoftRbac #yiisoftRbacPhp

Выполнили рефакторинг интерфейса хранилища назначений ролей/прав пользователям AssignmentsStorageInterface в пакете Yii Role-Based Access Control (PR):

• сделали более консистентные и понятные имена методов;

• в аргументах методов заменили объекты ролей/прав на их имена.

Соответствующим образом изменили реализацию хранилища в Yii RBAC PHP File Storage (PR).

⚡️ #yiisoftRbac #yiisoftRbacPhp #yiisoftDemo

Продолжаем рефакторинг Yii Role-Based Access Control (PR).

• RolesStorageInterface переименован в ItemsStorageInterface, а также переименованы методы:
getItems() → getAll()
getItemByName() → get()
addItem() → add()
updateItem() → update()
removeItem() → remove()
getChildren() → getAllChildren()
getRoleByName() → getRole()
getPermissionByName() → getPermission()
getChildrenByName() → getChildren()
getRuleByName() → getRule()

• В методах removeChildren(), removeChild(), addChild() и remove() интерфейса ItemsStorageInterface в качестве аргументов вместо объектов элементов RBAC теперь используются их имена.

• В интерфейсе AssignmentsStorageInterface переименованы методы:
getUserAssignments() → getByUserId()
removeUserAssignments() → removeByUserId()
removeItemAssignments() → removeByItemName()

• В методах get(), add() и remove() интерфейса AssignmentsStorageInterface изменён порядок методов:
string $userId, string $itemName → string $itemName, string $userId

• В RBAC-менеджере Manager объекты элементов RBAC заменены на их имена в качестве аргументов в следующих методах:
canAddChild()
addChild()
removeChild()
removeChildren()
hasChild()
assign()
revoke()
removeRole()
removePermission()

• В RBAC-менеджере Manager переименованы методы:
getUserIdsByRole() → getUserIdsByRoleName()
getPermissionsByUser() → getPermissionsByUserId
getPermissionsByRole() → getPermissionsByRoleName()
getRolesByUser() → getRolesByUserId()

• Исправлена ошибка в методе Manager::getDefaultRoles(): теперь возвращаются роли из хранилища, а не создаются новые.

Соответствующие изменения внесены в Yii RBAC PHP File Storage (PR) и демо веб-приложения (PR).

⚡️ #yiisoftRbac #yiisoftRbacPhp

В интерфейсе ItemsStorageInterface пакета Yii Role-Based Access Control заменили метод getAllChildren() на getParents() (PR).

Соответствующим образом адаптировали хранилище Yii RBAC PHP File Storage (PR).

⚡️ #yiisoftRbac #yiisoftRbacPhp #yiisoftDemo
✨ #yiisoftRbacRulesContainer

Переработали хранение и создание правил в пакете Yii Role-Based Access Control (PR). Теперь правила НЕ сохраняются в хранилище, а создаются с помощью абстрактной фабрики RuleFactoryInterface. Это позволило существенно упростить код:

- из хранилища ItemsStorageInterface удалены все методы, касающиеся правил;

- у правил теперь нет имён и соответственно удалён метод getName();

- удалён абстрактный класс Rule, так как он был нужен только для удобства работы с именем правила.

Вместо фабрики ClassNameRuleFactory в новом пакете Yii RBAC Rules Container создан контейнер правил RulesContainer (реализует интерфейс RuleFactoryInterface), позволяющий задавать конфигурацию правил с помощью синтаксиса Yii Definitions и использовать любой PSR-11 контейнер для разрешения зависимостей.

К этим изменениям адаптированы хранилище Yii RBAC PHP File Storage (PR) и демо веб-приложения (PR).

⚡️ #yiisoftRbac

В RBAC-менеджере библиотеки Yii Role-Based Access Control в качестве ID пользователя разрешено передавать строку, целое число или объект с методом __toString() (PR).

⚡️ #yiisoftRbac

В readme пакета Yii Role-Based Access Control добавили схему, иллюстрирующую пример иерархии разрешений и ролей (PR).

На GitHub'e в markdown-файлах добавили поддержку Mermaid. Этот инструмент позволяет описывать диаграммы в текстовом виде. Например, добавленная в readme схема в текстовом виде выглядит так:

```mermaid
flowchart LR
  createPost:::permission ---> author:::role
  readPost:::permission --> reader:::role --> author:::role
  deletePost:::permission ---> author:::role
  classDef permission fill:#fc0,stroke:#000,color:#000
  classDef role fill:#9c0,stroke:#000,color:#000

```

⚡️ #yiisoftRbac

Увеличили до 100% покрытие тестами пакета Yii Role-Based Access Control (PR).

⚡️ #yiisoftRbac

В пакете Yii Role-Based Access Control реализовали текучий интерфейс у класса Manager и добавили ещё тестов (PR).

Теперь можно делать, например, так:

$manager
    ->addPermission(new Permission('signup'))
    ->addRole(new Role('guest'))
    ->addChild('guest', 'signup');

⚡️ #yiisoftRbac

В пакете Yii Role-Based Access Control добавили ещё тестов и немного поправили стиль кода (PR).

⚡️ #yiisoftRbac

Немного доработали и причесали пакет Yii Role-Based Access Control (PR):

• исправлена ошибка: при удалении роли не удалялись связи роли с пользователем;

• удалён неиспользуемый код;

• обновлены dev-зависимости;

• версия экшена actions/cache в GitHub Actions поднята до 3;

• добавлены тесты, MSI увеличен до 95,8%.

⚡️ #yiisoftRbac #yiisoftRbacPhp

В пакете Yii Role-Based Access Control при добавлении роли или разрешения добавили проверку на существование в хранилище роли или разрешения с таким именем (PR).

Если роль или разрешение уже существуют (даже если добавляется роль, а существует разрешение, и наоборот), то будет брошено исключение ItemAlreadyExistsException.

Для проверки существования роли или разрешения был добавлен метод exists() в интерфейсе ItemsStorageInterface.

Новый метод уже реализован в пакете Yii RBAC PHP File Storage (PR).

#yiisoftRbac #yiisoftRbacPhp #yiisoftRbacRulesContainer #ПервыйРелиз #МажорныйРелиз #Релиз

🎁 Yii Role-Based Access Control 1.0.0

Библиотека для управления доступом на основе ролей (RBAC).

• Гибкая иерархия ролей, разрешений и правил.

• Наследование ролей и разрешений.

• Интерфейсы для хранилищ и фабрики правил.

• Возможность использовать разные хранилища для связки ролей с пользователями и иерархии ролей/разрешений.

• Удобное API для управления иерархией ролей/разрешений.


🎁 Yii RBAC PHP File Storage 1.0.0

Реализация хранилища для связки ролей с пользователями и иерархии ролей/разрешений на основе PHP-файлов.


🎁 Yii RBAC Rules Container 1.0.0

Фабрика для создания объектов правил RBAC на базе Yii Factory с использованием синтаксиса Yii Definition. Правила создаются один раз и кэшируются, при последующих запросах возвращается тот же экземпляр.

⚡️ #yiisoftRbac #yiisoftView #yiisoftYiiView #yiisoftYiiWidgets #yiisoftWidget #yiisoftYiiBulma #yiisoftYiiConsole #yiisoftRequirements #yiisoftYiiQueue #yiisoftYiiRunner #yiisoftMailer #yiisoftYiiDebugApi #yiisoftYiiQueueAmqp #yiisoftHtml #yiisoftYiiMiddleware #yiisoftValidator #yiisoftFiles #yiisoftPackageTemplate #yiisoftYiiBootstrap5 #yiisoftForm #yiisoftClassifier #yiisoftYiiDevTool

Заменили рабочие процессы на переиспользуемые из Yii GitHub Actions в пакетах:

- Yii Role-Based Access Control (PR)
- Yii View (PR)
- Yii View Extension (PR)
- Yii Widgets (PR)
- Yii Widget (PR)
- Yii Bulma (PR)
- Yii Console (PR)
- Yii Requirements Checker (PR)
- Yii Queue (PR)
- Yii Runner (PR)
- Yii Mailer Library (PR)
- Yii Debug API (PR)
- Yii Queue AMQP Driver (PR)
- Yii HTML (PR)
- Yii Middleware (PR)
- Yii Validator (PR)
- Yii Files (PR)
- Yii Package Template (PR)
- Yii Bootstrap 5 (PR)
- Yii Form (PR)
- Yii Classifier (PR)
- Yii Development Tool (PR)

⚡️ #yiisoftMailer #yiisoftLogTargetSyslog #yiisoftHttp #yiisoftI18n #yiisoftLog #yiisoftLogTargetDb #yiisoftLogTargetEmail #yiisoftMailerSymfony #yiisoftMiddlewareDispatcher #yiisoftMutexPdoOracle #yiisoftMutexRedis #yiisoftRbac #yiisoftRbacDb #yiisoftRbacPhp #yiisoftRequestBodyParser #yiisoftRateLimiter #yiisoftProxy #yiisoftProfiler #yiisoftMutexPdoPgsql #yiisoftMutexPdoMysql #yiisoftMailerSwiftmailer #yiisoftHtml #yiisoftRequestModel #yiisoftRequirements #yiisoftRouter #yiisoftRouterFastroute #yiisoftSession #yiisoftStrings #yiisoftTestSupport #yiisoftTranslator #yiisoftTranslatorMessageDb #yiisoftUser #yiisoftView #yiisoftViewTwig #yiisoftWidget #yiisoftYiiConsole

Сделали изменения в стили кода. Методы, вызываемые «цепочкой», перенесли на новую строку:

- Yii Mailer Library (PR)
- Yii Logging Syslog Target (PR)
- Yii HTTP (PR)
- Yii Internationalization Library (PR)
- Yii Logging Library (PR)
- Yii Logging DB Target (PR)
- Yii Logging Email Target (PR)
- Yii Mailer Symfony Mailer Extension (PR)
- Yii Middleware Dispatcher (PR)
- Yii Mutex Oracle PDO Driver (PR)
- Yii Mutex Redis Driver (PR)
- Yii Role-Based Access Control (PR)
- Yii RBAC Database (PR)
- Yii RBAC PHP File Storage (PR)
- Yii Request Body Parser (PR)
- Yii Rate Limiter Middleware (PR)
- Yii Proxy (PR)
- Yii Profiler (PR)
- Yii Mutex PostgreSQL PDO Driver (PR)
- Yii Mutex MySQL PDO Driver (PR)
- Yii Mailer SwiftMailer Extension (PR)
- Yii HTML (PR)
- Yii Request Model (PR)
- Yii Requirements Checker (PR)
- Yii Router (PR)
- Yii Router FastRoute Adapter (PR)
- Yii Session (PR)
- Yii Strings (PR)
- Yii Test Support (PR)
- Yii Message Translator (PR)
- Yii Translator DB Message Storage (PR)
- Yii User (PR)
- Yii View (PR)
- Yii View Twig Renderer (PR)
- Yii Widget (PR)
- Yii Console (PR)

⚡️ #yiisoftRbac

В Yii Role-Based Access Control исправили опечатку в phpdoc (PR) и реализовали дружественное исключение для случая, когда роли по умолчанию не найдены (PR).

⚡️ #yiisoftRbac #yiisoftMutex #yiisoftMutexPdoOracle #yiisoftMutexPdoPgsql #yiisoftMutexPdoMysql #yiisoftDataResponse

Обновили версию vimeo/psalm до ^4.30|^5.3 в пакетах:

- Yii Mutex (PR),
- Yii Mutex Oracle PDO Driver (PR),
- Yii Mutex PostgreSQL PDO Driver (PR),
- Yii Mutex MySQL PDO Driver (PR),
- Yii Role-Based Access Control (PR),
- Yii Data Response (PR).

#yiisoftRbac #ПатчРелиз #Релиз

🎁 Yii Role-Based Access Control 1.0.1

• При получении несуществующих дефолтных ролей теперь выбрасывается исключение, притом "дружественное".

😎 Релиз подготовил Dmitriy Goriaev.