aeruz/app-registry

A PHP library for managing an application registry with lifecycle management (draft/published), locking, and user access control.

0.0.1 2026-01-09 09:11 UTC

Requires

• php: ^8.4
• aeruz/app-registry-common: ^0.0

Requires (Dev)

• phpstan/extension-installer: ^1.4.3
• phpstan/phpstan: ^2.1.33
• phpstan/phpstan-deprecation-rules: ^2.0.3
• phpstan/phpstan-phpunit: ^2.0.11
• phpstan/phpstan-strict-rules: ^2.0.7
• phpunit/phpunit: ^12.5.4

MIT

README

A PHP library to manage an application registry with support for draft/published states, lifecycle management, and user access control.

Installation

composer require aeruz/app-registry

Basic Usage

use Aeruz\AppRegistry\ApplicationsRegistry;
use Aeruz\AppRegistry\RegistrationMode;

// Initialize with your repository implementations
$registry = new ApplicationsRegistry(
    $publishedRepo,
    $draftRepo,
    $accessRepo
);

// Register a new application as a draft
$registry->register($application, RegistrationMode::PESSIMISTIC);

// Publish it
$registry->publish($application->identifier);

// Grant access to a user
$registry->grantUserAccessTo('user_123', $application->identifier);

Advanced Documentation

For more detailed information, please refer to the following guides in the doc/ directory:

• Application Registration: Understanding Optimistic vs Pessimistic modes.
• Application Lifecycle: Managing states (Draft, Published), enabling/disabling, and locking.
• User Access Management: How to grant and check user permissions.
• Repositories & Persistence: Implementing storage and transaction management.

License

This library is licensed under the MIT License.