nepada/presenter-mapping

Improved presenter mapping for PresenterFactory from Nette.

v2.5.0 2023-09-28 18:12 UTC

Requires

• php: >=8.1.0 <8.4
• nette/application: ^3.1.4@dev
• nette/utils: ^3.2@dev || ^4.0@dev

Requires (Dev)

• nepada/coding-standard: 7.13.0
• nepada/phpstan-nette-tester: 1.1.0
• nette/bootstrap: >=3.1@dev
• nette/di: ^3.0.6@dev
• nette/tester: 2.5.1
• php-parallel-lint/php-parallel-lint: 1.3.2
• phpstan/phpstan: 1.10.32
• phpstan/phpstan-nette: 1.2.9
• phpstan/phpstan-strict-rules: 1.5.1
• shipmonk/phpstan-rules: 2.7.0
• spaze/phpstan-disallowed-calls: 2.16.0

Suggests

• nette/di: for integration with Nette DI container

BSD-3-Clause

• Petr Morávek

• nette
• mapping
• presenter

README

Installation

Via Composer:

$ composer require nepada/presenter-mapping

Register the extension in config.neon:

extensions:
    - Nepada\Bridges\PresenterMappingDI\PresenterMappingExtension

Usage

The extension replaces standard PresenterFactory provided by ApplicationExtension and adds extended support for presenter mapping. The new presenter mapping system is fully compatible with simple mapping from Nette.

Submodule mapping

Nette supports mapping based only on the root module name, this package adds support for separate mapping for submodules. You can define different mapping for submodule Foo:Bar and it will take precendence over the mapping defined for Foo and * respectively.

Example:

application:
    mapping:
        '*': ['App', 'Module\*', 'Presenter\*']
        'Foo': Foo\*Module\*Presenter
        'Foo:Bar': Bar\*Module\*Presenter

Presenter class mapping

You can define mapping between presenter name and class directly for individual presenters. This is especially useful when you need to override a single presenter from a module provided for example by external composer package.

Example:

application:
    mapping:
        'Foo:Bar:Baz': FooBar\BazPresenter

Configuration from another CompilerExtension

Some extensions may need to setup their own presenter mappings, this can be done in beforeCompile() phase by customizing setup of PresenterMapper.

$presenterMapper = $containerBuilder->getByType(Nepada\PresenterMapping\PresenterMapper::class);
$containerBuilder->getDefinition($presenterMapper)
    ->addSetup('setPresenterMapping', ['Foo:Bar:Baz', FooBar\BazPresenter::class])
    ->addSetup('setModuleMapping', ['Foo:Bar', 'Bar\*Module\*Presenter'])
    ->addSetup('setModuleMapping', ['Foo', 'Foo\*Module\*Presenter']);