PMU is a Composer plugin for PHP Monorepository management.

composer require --dev soyuka/pmu
composer global require --dev soyuka/pmu # ability to link projects globally

{
  "name": "test/monorepo",
  // Specify the projects that are part of your monorepository
  "extra": {
    "pmu": {
        "projects": ["./packages/*/composer.json"]
    }
  },
  "config": {
      "allow-plugins": {
          "soyuka/pmu": true
      }
  }
}

Note that repositories are propagated to each project when running commands from the base composer.json file. An example is available in the tests/monorepo directory.

composer [project-name] [args]

For example: composer test/a install.

composer all install

Runs composer install on every projects.

For example to change the branch alias:

composer all config extra.branch-alias.dev-main 3.3.x-dev -vvv

Blend your root composer.json constraints in each of the projects.

composer blend [--dev] [project-name]

Note: there's no dry mode on this command, use a VCS to rollback on unwanted changes.

When project-a depends on dependency-a:^2.0.0 and your root project has dependency-a:^3.0.0, running composer blend will set the requirement of dependency-a to ^3.0.0 in project-a.

We do not check if a dependency is valid, you should probably run composer all validate or composer all update after running this.

Blend can also transfer any json path:

composer blend --json-path=extra.branch-alias.dev-main --force

Where force will write even if the value is not present in the project's composer.json.

composer graph [project-name]

Example: composer graph test/a to see the dependencies for the test/a project.

This script reads the code and detect use classes. It then checks that the dependencies are correctly mapped in the require or require-dev of each project.

composer check-dependencies

To link your project's mono-repository dependencies use composer link. This will create a temporary composer definition with:

• configured repository on each project's path
• add a @dev constraint to force composer to run local symlinks
• run composer update
• revert the definition to the previous ones (we recommend running this command after setting up a version control system)

You can run this command on a global install to link a directory to the current project:

composer global link ../the-mono-repository --working-directory=$(pwd)

• create and affected graph to be able to run tests on affected projects