PHPackages jinexus-framework/jinexus-module-manager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. jinexus-framework/jinexus-module-manager ActiveComponent[Framework](/categories/framework) jinexus-framework/jinexus-module-manager ======================================== Module Manager component from JiNexus Framework 1.0.0(7y ago)0381BSD-3-ClausePHPPHP ^5.6 || ^7.0 Since Dec 10Pushed 7y ago1 watchersCompare [ Source](https://github.com/jinexus-framework/jinexus-module-manager)[ Packagist](https://packagist.org/packages/jinexus-framework/jinexus-module-manager)[ Docs](https://github.com/jinexus-framework/jinexus-module-manager)[ RSS](/packages/jinexus-framework-jinexus-module-manager/feed)WikiDiscussions master Synced 4w ago READMEChangelog (2)DependenciesVersions (4)Used By (1) JiNexus Module Manager ====================== [](#jinexus-module-manager) `JiNexus Module Manager` provides a simple modular approach for jinexus-mvc applications. It keeps an ordered registry of module namespaces and resolves any of them to a configuration array by convention — append `\Module` to the namespace, instantiate it, and ask it for its config. The package intentionally ships no concrete module. Your application provides its own `Vendor\Package\Module` class extending `AbstractModule`, returning whatever that module contributes (routes, services, view paths, and so on). - Documentation: - Issues: Requirements ------------ [](#requirements) - PHP `^8.5` Installation ------------ [](#installation) Install via [Composer](https://getcomposer.org/): ``` composer require jinexus-framework/jinexus-module-manager ``` Usage ----- [](#usage) ### Creating a module manager [](#creating-a-module-manager) ``` use JiNexus\ModuleManager\ModuleManager\ModuleManager; use JiNexus\ModuleManager\ModuleManager\Factory\ModuleManagerFactory; $manager = new ModuleManager(); // ...or via the factory (a fresh, independent instance each call). $manager = ModuleManagerFactory::build(); ``` ### Registering modules [](#registering-modules) Modules are registered as **namespace strings**, not class names or objects: ``` $manager->setModules(['Acme\Blog', 'Acme\Shop']); $manager->getModules(); // ['Acme\Blog', 'Acme\Shop'] $manager->addModule('Acme\Wiki'); // true — appended $manager->addModule('Acme\Wiki'); // false — already registered ``` Two things about `setModules()` are worth knowing up front, because they differ from a conventional setter: ``` $manager->setModules(['Acme\Blog']); $manager->setModules(['Acme\Shop']); $manager->getModules(); // ['Acme\Blog', 'Acme\Shop'] — it appends, it does not replace $manager->setModules([]); // a no-op, NOT a reset $manager->setModules(['blog' => 'Acme\Blog']); $manager->getModules(); // keys are discarded; the list is re-indexed ``` `setModules()` does not deduplicate — only `addModule()` checks for an existing entry, and it reports whether the module was actually added. ### Writing a module [](#writing-a-module) Extend `AbstractModule` and override `getConfig()`. The class must be named `Module` and sit directly under the namespace you register: ``` namespace Acme\Blog; use JiNexus\ModuleManager\ModuleManager\AbstractModule; class Module extends AbstractModule { public function getConfig(): array { return [ 'name' => 'blog', 'routes' => ['blog' => ['route' => '/blog']], ]; } } ``` `AbstractModule::getConfig()` returns `[]`, so a module that overrides nothing is valid and simply contributes no configuration. ### Reading a module's config [](#reading-a-modules-config) ``` $manager->getConfig('Acme\Blog'); // instantiates Acme\Blog\Module and returns its getConfig() result ``` The argument is the namespace **above** the module class — `\Module` is appended for you. Resolution is independent of registration: a module does not have to be added to the manager before its config can be read. ``` foreach ($manager->getModules() as $module) { $config = $manager->getConfig($module); // merge it into your application config however your app prefers } ``` The manager returns each module's config as-is; merging, validating, and caching are left to the consuming application. ### Error handling [](#error-handling) Package-level failures throw `JiNexus\ModuleManager\ModuleManagerException` (a subclass of `\Exception`): ``` $manager->getConfig(); // ModuleManagerException: Module is required $manager->getConfig(''); // ModuleManagerException: Module is required ``` An unsupported magic getter/setter resolved through `AbstractBase::__call` also throws a `ModuleManagerException` with a `Not implemented: …` message. An unresolvable namespace also throws a `ModuleManagerException`: ``` $manager->getConfig('No\Such\Vendor'); // ModuleManagerException: Module class "No\Such\Vendor\Module" cannot be resolved ``` Upgrading from 1.0.0 -------------------- [](#upgrading-from-100) Version 1.1.0 raises the PHP floor to `^8.5` and renames the package exception: ``` // 1.0 use JiNexus\ModuleManager\Exception; // 1.1 use JiNexus\ModuleManager\ModuleManagerException; ``` It also adds parameter and return types across the public API, so if you implement `ModuleInterface`/`ModuleManagerInterface` or extend `AbstractModule`/`AbstractModuleManager`, your overrides need matching declarations — notably `getConfig(): array`. See [CHANGELOG.md](CHANGELOG.md) for the full upgrade notes. Extending --------- [](#extending) `ModuleManager` is a deliberately empty subclass of `AbstractModuleManager` — all behavior lives on the abstract so the concrete class stays a stable extension point. Extend `AbstractModuleManager` when you want to change registry behavior and extend `AbstractModule` for your application's modules. `ModuleManagerInterface` declares `getModules()` and `getConfig()` as `mixed`; `AbstractModuleManager` narrows both to `array`. Implementations may narrow further. Testing ------- [](#testing) ``` composer install composer test # or: ./vendor/bin/phpunit composer test:coverage # text coverage report composer test:testdox # readable, per-test output ``` `phpunit.dist.xml` is the committed configuration. Use `XDEBUG_MODE=off` to silence the local Xdebug notice: ``` XDEBUG_MODE=off ./vendor/bin/phpunit --testdox ``` Contributing ------------ [](#contributing) Please see [CONDUCT.md](CONDUCT.md) for the code of conduct. Contributions should include tests and a `CHANGELOG.md` entry. See [AGENTS.md](AGENTS.md) for detailed build, style, and workflow conventions. License ------- [](#license) BSD-3-Clause. See [LICENSE.md](LICENSE.md). ### Health Score 26 — LowBetter than 40% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community9 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 2804d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/6903966?v=4)[Jimvirle Calago](/maintainers/JiNexus)[@JiNexus](https://github.com/JiNexus) --- Top Contributors [![JiNexus](https://avatars.githubusercontent.com/u/6903966?v=4)](https://github.com/JiNexus "JiNexus (3 commits)") --- Tags Module Managerjinexus ### Embed Badge ![Health badge](/badges/jinexus-framework-jinexus-module-manager/health.svg) ``` [![Health](https://phpackages.com/badges/jinexus-framework-jinexus-module-manager/health.svg)](https://phpackages.com/packages/jinexus-framework-jinexus-module-manager) ``` ### Alternatives [nasirkhan/module-manager Module Manager & Generator for Laravel Starter Kit (https://github.com/nasirkhan/laravel-starter) 1046.5k6](/packages/nasirkhan-module-manager)[nineinchnick/edatatables Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin 173.2k](/packages/nineinchnick-edatatables) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)