jeichorn/composer-monorepo-plugin

Wednesday, June 14, 2017
by jeichorn
Repository
1 Watchers
0 Stars
3,726 Installations

PHP
0 Dependents
0 Suggesters
26 Forks
0 Open issues
31 Versions
21 % Grown

The README.md

Composer Monorepo Plugin

, _(*1)

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., _(*2)

Repositories managed with this plugin contain two kinds of packages:, _(*3)

Composer packages defined by a single global composer.json with all external dependencies at the root of the repository.
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., _(*4)

This plugins build step generates autoloaders with vendor/autoload.php files for each package with access to the explicitly specified dependencies only., _(*5)

The following steps are performed by this plugin when building the autoloads:, _(*6)

It detects monorepo.json files in subdirectories excluding vendor/ and marks them as roots of packages.
It then fetches all composer packages from the locally installed packages.
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 and Facebook Buck implementing a single monolithic repository for whole projects/company. It's the missing piece for the monolithic repository workflow using PHP and Composer., _(*7)

More details about reasoning on Gregory Szorc's blog:, _(*8)

Forked

This is a forked version of the original https://github.com/beberlei/composer-monorepo-plugin, since it was no longer under active development, _(*9)

Installation

Add the composer monorepo plugin to your root composer.json with:, _(*10)

$ composer require jeichorn/composer-monorepo-plugin

It will be automatically added as a Composer plugin., _(*11)

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., _(*12)

You can execute the autoload generation step for just the subpackages by calling:, _(*13)

$ 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., _(*14)

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., _(*15)

Then, each of your own package contains a monorepo.json using almost the same syntax as Composer:, _(*16)

{
    "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., _(*17)

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)., _(*18)

Package names in deps are the relative directory names from the project root, not Composer package names., _(*19)

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., _(*20)

Configuration Schema monorepo.json

For each package in your monolithic repository you have to add monorepo.json that borrows from composer.json format. The following keys are usable:, _(*21)

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
bin-deploy-method - symlink|copy, the standard method symlink, deploys vendor/bin scripts as symlinks to the parent vendor/bin. This breaks cases where you want to use the autoload ands its dependencies in a child repo. Copy copies the bins into vendor/bin in the child and then symlinks them so standard script discovery works.

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:, _(*22)

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

The Versions

14/06 2017

dev-master

9999999-dev

composer-plugin composer-monorepo-plugin

jeichorn/composer-monorepo-plugin

The README.md

Composer Monorepo Plugin

Forked

Installation

Usage

Configuration Schema monorepo.json

Git Integration for Builds

The Versions

dev-master

The Requires

The Development Requires

v0.12.6

The Requires

The Development Requires

v0.12.5

The Requires

The Development Requires

v0.12.4

The Requires

The Development Requires

v0.12.3

The Requires

The Development Requires

v0.12.2

The Requires

The Development Requires

v0.12.1

The Requires

The Development Requires

dev-relative-symlinks

The Requires

The Development Requires

v0.12

The Requires

The Development Requires

v0.11.6

The Requires

The Development Requires

v0.11.5

The Requires

The Development Requires

v0.11.4

The Requires

The Development Requires

v0.11.3

The Requires

The Development Requires

v0.11.2

The Requires

The Development Requires

v0.11.1

The Requires

The Development Requires

v0.11

The Requires

The Development Requires

v0.10.3

The Requires

The Development Requires

v0.10.2

The Requires

The Development Requires

v0.10.1

The Requires

The Development Requires

v0.10

The Requires

The Development Requires

v0.9

The Requires

The Development Requires

v0.8.1

The Requires

The Development Requires

v0.8

The Requires

The Development Requires

dev-Composer-Plugin