PHPackages                             ollieread/composer-local-repositories - 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. [Utility & Helpers](/categories/utility)
4. /
5. ollieread/composer-local-repositories

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

ollieread/composer-local-repositories
=====================================

Composer plugin that automatically loads local package repositories

v1.0(1y ago)15322MITPHPPHP ^8.1

Since Nov 25Pushed 1y ago2 watchersCompare

[ Source](https://github.com/ollieread/composer-local-repositories)[ Packagist](https://packagist.org/packages/ollieread/composer-local-repositories)[ RSS](/packages/ollieread-composer-local-repositories/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Composer Local Repositories
===========================

[](#composer-local-repositories)

The composer plugin to quickly add local repositories for development purposes, without the need to update your `composer.json` file.

How to install
--------------

[](#how-to-install)

```
composer global require ollieread/composer-local-repositories
```

How to use
----------

[](#how-to-use)

Add a `repositories.json` file to any project that you want to add a custom repository to. The file needs to contain a valid composer `repositories` key. For example:

**`repositories.json`**

```
{
  "repositories": [
    {
      "type": "path",
      "url": "../local-folder"
    }
  ]
}
```

During a `composer install` or `composer update`, the plugin will locate the `repositories.json` file; and prepend all the configured repositories. If composer finds any of the `require` packages inside these repositories, it will install the package from that repository instead.

Configuration
-------------

[](#configuration)

To configure the plugin, you can provide extra configuration keys under a `local-repositories` key in the `extra`section.

- `trigger-commands` An array of composer commands that loads the local `repositories.json` file (default: `install`and `update`)
- `ignore-flags` An array of flags on which to ignore the local `repositories.json` file (default: `--no-dev`and `--prefer-source`)
- `force-dev` Whether to update the constraint of any found packages from local repositories with `@dev` ( default: `true`)

Full configuration example with default values:

**global `composer.json`**

```
{
  "extra": {
    "local-repositories": {
      "trigger-commands": [
        "install",
        "update"
      ],
      "ignore-flags": [
        "no-dev",
        "prefer-source"
      ],
      "force-dev": true
    }
  }
}
```

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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

Unknown

Total

1

Last Release

579d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/469515?v=4)[Ollie Read](/maintainers/ollieread)[@ollieread](https://github.com/ollieread)

---

Top Contributors

[![doekenorg](https://avatars.githubusercontent.com/u/529515?v=4)](https://github.com/doekenorg "doekenorg (2 commits)")[![ollieread](https://avatars.githubusercontent.com/u/469515?v=4)](https://github.com/ollieread "ollieread (2 commits)")[![ruudk](https://avatars.githubusercontent.com/u/104180?v=4)](https://github.com/ruudk "ruudk (1 commits)")

---

Tags

composercomposer-pluginlocal-developmentphpphp-package-development

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ollieread-composer-local-repositories/health.svg)

```
[![Health](https://phpackages.com/badges/ollieread-composer-local-repositories/health.svg)](https://phpackages.com/packages/ollieread-composer-local-repositories)
```

###  Alternatives

[symfony/runtime

Enables decoupling PHP applications from global state

74694.9M938](/packages/symfony-runtime)[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k40.0M2.6k](/packages/ergebnis-composer-normalize)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5344.1M526](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.0M193](/packages/drupal-core-project-message)[sandersander/composer-link

Adds ability to link local packages for development with composer

94441.4k](/packages/sandersander-composer-link)[phpro/grumphp-shim

GrumPHP Phar distribution

284.6M333](/packages/phpro-grumphp-shim)

PHPackages © 2026

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