PHPackages                             bronek89/composer-monorepo-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bronek89/composer-monorepo-plugin

ActiveComposer-plugin

bronek89/composer-monorepo-plugin
=================================

Composer plugin to handle monorepo.

v0.13(9y ago)02.4kMITPHP

Since Apr 10Pushed 9y ago1 watchersCompare

[ Source](https://github.com/bronek89/composer-monorepo-plugin)[ Packagist](https://packagist.org/packages/bronek89/composer-monorepo-plugin)[ RSS](/packages/bronek89-composer-monorepo-plugin/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)Dependencies (4)Versions (26)Used By (0)

Composer Monorepo Plugin
========================

[](#composer-monorepo-plugin)

```
Note: this project is still experimental. Please provide feedback!

```

This plugin adds support for Monorepos when using Composer package manager. It introduces a maintainable approach to managing dependencies for multiple packages in a single repository, without losing the benefits of having explicit dependencies for each separate package.

Repositories managed with this plugin contain two kinds of packages:

1. Composer packages defined by a single global `composer.json` with all external dependencies at the root of the repository.
2. Many monorepo packages in sub-folders of the project, each with its own `monorepo.json`, a simplified `composer.json` file.

Dependencies in monorepos can be either a third party Composer package that is listed in the `composer.json` or a monorepo package contained in the project.

This plugins build step generates autoloaders with `vendor/autoload.php` files for each package with access to the explicitly specified dependencies only.

The following steps are performed by this plugin when building the autoloads:

1. It detects `monorepo.json` files in subdirectories excluding `vendor/` and marks them as roots of packages.
2. It then fetches all composer packages from the locally installed packages.
3. Finally for each package with `monorepo.json` it generates a `vendor/autoload.php` file using all the dependencies defined in that package from either other monorepo packages or regular Composer packages.

This plugin draws inspiration from Google [Blaze/Bazel](http://bazel.io/) and Facebook [Buck](http://facebook.github.io/buck/) implementing a single monolithic repository for whole projects/company. It's the missing piece for the monolithic repository workflow using PHP and Composer.

More details about reasoning on Gregory Szorc's blog:

- [On Monlithic Repositories](http://gregoryszorc.com/blog/2014/09/09/on-monolithic-repositories/)
- [Notes from Facebooks Developer Infrastructure at Scale F8 talk](http://gregoryszorc.com/blog/2015/03/28/notes-from-facebook's-developer-infrastructure-at-scale-f8-talk/)

Backwards Incompatible Changes in v0.12
---------------------------------------

[](#backwards-incompatible-changes-in-v012)

In v0.12 we removed the `fiddler` script and the possibility to build a PHAR archive. This project is now a first-class composer plugin only and requires Composer v1.1+ for the `composer monorepo:` commands to be available.

The `fiddler.json` files must be renamed to `monorepo.json`.

Use v0.11.6 or lower if you don't want to break this in your project yet.

Installation
------------

[](#installation)

Add the composer monorepo plugin to your root composer.json with:

```
$ composer require beberlei/composer-monorepo-plugin

```

It will be automatically added as a Composer plugin.

Usage
-----

[](#usage)

Whenever Composer generates autoload files (during install, update or dump-autoload) it will find all sub-directories with `monorepo.json` files and generate sub-package autoloaders for them.

You can execute the autoload generation step for just the subpackages by calling:

```
$ composer monorepo:build

```

You create a `composer.json` file in the root of your project and use this single source of vendor libraries across all of your own packages.

This sounds counter-intuitive to the Composer approach at first, but it simplifies dependency management for a big project massively. Usually if you are using a composer.json per package, you have mass update sprees where you upate some basic library like "symfony/dependency-injection" in 10-20 packages or worse, have massively out of date packages and many different versions everywhere.

Then, each of your own package contains a `monorepo.json` using almost the same syntax as Composer:

```
{
    "deps": [
        "components/Foo",
        "vendor/symfony/symfony"
    ],
    "autoload": {
        "psr-0": {"Foo\\": "src/"}
    }
}

```

You can then run `composer dump-autoload` in the root directory next to composer.json and this plugin will detect all packages, generate a custom autoloader for each one by simulating `composer dump-autoload` as if a composer.json were present in the subdirectory.

This plugin will resolve all dependencies (without version constraints, because it is assumed the code is present in the correct versions in a monolithic repository).

Package names in `deps` are the relative directory names from the project root, *not* Composer package names.

You can just `require "vendor/autoload.php;` in every package as if you were using Composer. Only autoloads from the `monorepo.json` are included, which means all dependencies must be explicitly specified.

Configuration Schema monorepo.json
----------------------------------

[](#configuration-schema-monorepojson)

For each package in your monolithic repository you have to add `monorepo.json`that borrows from `composer.json` format. The following keys are usable:

- `autoload` - configures the autoload settings for the current package classes and files.
- `autoload-dev` - configures dev autoload requirements. Currently *always* evalauted.
- `deps` - configures the required dependencies in an array (no key-value pairs with versions) using the relative path to the project root directory as a package name.
- `deps-dev` - configures the required dev dependencies

Git Integration for Builds
--------------------------

[](#git-integration-for-builds)

In a monorepo, for every git commit range you want to know which components changed. You can test with the `git-changed?` command:

```
composer monorepo:git-changed? components/foo $TRAVIS_COMMIT_RANGE
if [ $? -eq 0 ]; then ant build fi
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 80.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Recently: every ~67 days

Total

23

Last Release

3366d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/513fc5787b46310616547ad0ddfaae3c14b9bf78bdc2bf757e3c2c8727f246a9?d=identicon)[bronek89](/maintainers/bronek89)

---

Top Contributors

[![beberlei](https://avatars.githubusercontent.com/u/26936?v=4)](https://github.com/beberlei "beberlei (86 commits)")[![boekkooi](https://avatars.githubusercontent.com/u/399895?v=4)](https://github.com/boekkooi "boekkooi (6 commits)")[![bronek89](https://avatars.githubusercontent.com/u/3485209?v=4)](https://github.com/bronek89 "bronek89 (5 commits)")[![wjzijderveld](https://avatars.githubusercontent.com/u/450201?v=4)](https://github.com/wjzijderveld "wjzijderveld (4 commits)")[![orthographic-pedant](https://avatars.githubusercontent.com/u/14522744?v=4)](https://github.com/orthographic-pedant "orthographic-pedant (1 commits)")[![ribeiropaulor](https://avatars.githubusercontent.com/u/376830?v=4)](https://github.com/ribeiropaulor "ribeiropaulor (1 commits)")[![TiMESPLiNTER](https://avatars.githubusercontent.com/u/598854?v=4)](https://github.com/TiMESPLiNTER "TiMESPLiNTER (1 commits)")[![timglabisch](https://avatars.githubusercontent.com/u/689269?v=4)](https://github.com/timglabisch "timglabisch (1 commits)")[![timroberson](https://avatars.githubusercontent.com/u/913294?v=4)](https://github.com/timroberson "timroberson (1 commits)")[![cxj](https://avatars.githubusercontent.com/u/446131?v=4)](https://github.com/cxj "cxj (1 commits)")

---

Tags

composercomposer-pluginmonorepophp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bronek89-composer-monorepo-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/bronek89-composer-monorepo-plugin/health.svg)](https://phpackages.com/packages/bronek89-composer-monorepo-plugin)
```

###  Alternatives

[humbug/box

Fast, zero config application bundler with PHARs.

1.3k801.5k68](/packages/humbug-box)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M15](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M444](/packages/drupal-core-composer-scaffold)[roots/wordpress-core-installer

A Composer custom installer to handle installing WordPress as a dependency

4115.6M19](/packages/roots-wordpress-core-installer)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)