mahocommerce / maho-composer-plugin

v4.6.0 2026-09-11 10:37 UTC

Requires

• php: >=8.3
• composer-plugin-api: ^2.1
• composer-runtime-api: ^2
• symfony/routing: ^7.4

Requires (Dev)

• api-platform/core: ^4.0
• composer/composer: ^2.9.3
• friendsofphp/php-cs-fixer: *
• phpstan/phpstan: ^2.0
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• rector/rector: *

MIT

Published on Packagist.org on 2026-09-11 10:37 UTC

README

Configuration

The plugin reads all its options from the extra key of a composer.json file. All options are optional.

extra.maho.publish-assets

Read from the root package. A boolean. The default is false.

A module repository is not a deployment target. When you run Composer inside a module repository, the plugin does not copy the Maho public/ tree, the maho CLI, or the assets of other modules into it. This keeps the working copy clean.

Set this option to true to publish the assets anyway. Use it when a module repository must also work as a test store.

{
    "type": "maho-module",
    "extra": {
        "maho": {
            "publish-assets": true
        }
    }
}

This option has no effect on a project. A project always gets the assets.

extra.maho.preserve-files

Read from the root package. An array of strings.

Each string is a file path. The path is relative to the project directory. The plugin does not overwrite a listed file if the file already exists. Use it to protect a file that you changed in the project.

{
    "extra": {
        "maho": {
            "preserve-files": [
                "public/robots.txt",
                "public/favicon.ico"
            ]
        }
    }
}

extra.map

Read from a module package. An array of [source, target] pairs.

The plugin uses this option only when the module has no modman file. It gives compatibility with Cotya/magento-composer-installer. A modman file is the preferred format.

{
    "type": "maho-module",
    "extra": {
        "map": [
            ["src/app/code/community/Acme/Example", "app/code/community/Acme/Example"],
            ["src/app/etc/modules/Acme_Example.xml", "app/etc/modules/Acme_Example.xml"]
        ]
    }
}