microweber-deps / composer-installers-extender
Extend the composer/installers plugin to accept any arbitrary package type.
Installs: 6
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 52
Type:composer-plugin
Requires
- composer-plugin-api: ^1.0
- composer/installers: ^1.0
This package is auto-updated.
Last update: 2024-12-14 21:31:56 UTC
README
The composer-installers-extender
is a plugin for Composer that allows
any package to be installed to a directory other than the default vendor/
directory within
the repo on a package-by-package basis. This plugin extends the composer/installers
plugin to allow any arbitrary package type to be handled by their custom installer and specified explicitly in the
"installer-paths"
mapping in the "extra"
data property.
composer/installers
has a finite set of supported package types and we recognize the need for
any arbitrary package type to be installed to a specific directory other than vendor/
. This plugin
allows additional package types to be handled by composer/installers
, benefiting from their explicit install path
mapping and token replacement of package properties.
How to Use
Add oomphinc/composer-installers-extender
as a dependency of your project.
composer require oomphinc/composer-installers-extender
composer/installers
is a dependency of this plugin and will be automatically required as well.
To support additional package types, add an array of these types in the "extra"
property in your composer.json
:
"extra": {
"installer-types": ["library"]
}
Then, you can add mappings for packages of these types in the same way that you would add package types
that are supported by composer/installers
:
"extra": {
"installer-types": ["library"],
"installer-paths": {
"special/package/": ["my/package"],
"path/to/libraries/{$name}/": ["type:library"]
}
}
By default, packages that do not specify a type
will be considered type library
. Adding support for this type
allows any of these packages to be placed in a different install path.
If a type has been added to "installer-types"
, the plugin will attempt to find an explicit installer path in the mapping.
If there is no match either by name or by type, the default installer path for all packages will be used instead.
Please see the README for composer/installers
to see the supported
syntax for package and type matching as well as the supported replacement tokens in the path (e.g. {$name}
).