xerkus / laminas-component-installer

Composer plugin for injecting modules and configuration providers into application configuration

Component Installer for Laminas and Mezzio Applications

This repository contains the Composer plugin class Laminas\ComponentInstaller\ComponentInstaller, which provides Composer event hooks for the events:

• post-package-install
• post-package-uninstall

Via Composer global install

To install the utility for use with all projects you use:

$ composer global require laminas/laminas-component-installer

Per project installation

To install the utility for use with a specific project already managed by composer:

$ composer require laminas/laminas-component-installer

Writing packages that utilize the installer

Packages can opt-in to the workflow from laminas-component-installer by defining one or more of the following keys under the extra.laminas configuration in their composer.json file:

"extra": {
  "laminas": {
    "component": "Component\\Namespace",
    "config-provider": "Classname\\For\\ConfigProvider",
    "module": "Module\\Namespace"
  }
}

• A component is for use specifically with laminas-mvc + laminas-modulemanager; a Module class must be present in the namespace associated with it. The setting indicates a low-level component that should be injected to the top of the modules list of one of:

  • config/application.config.php
  • config/modules.config.php
  • config/development.config.php

• A module is for use specifically with laminas-mvc + laminas-modulemanager; a Module class must be present in the namespace associated with it. The setting indicates a userland or third-party module that should be injected to the bottom of the modules list of one of:

  • config/application.config.php
  • config/modules.config.php
  • config/development.config.php

• A config-provider is for use with applications that utilize mezzio-config-manager or laminas-config-aggregator (which may or may not be Mezzio applications). The class listed must be an invokable that returns an array of configuration, and will be injected at the top of:

  • config/config.php

Whitelisting packages to install automatically

At the project level, you can mark packages that expose configuration providers and modules that you want to automatically inject via the component-whitelist key:

"extra": {
  "laminas": {
    "component-whitelist": [
      "mezzio/mezzio",
      "mezzio/mezzio-helpers"
    ]
  }
}

This configuration must be made at the root package level (the package consuming configuration providing packages).