sbuerk/extended-path-repository

Composer plugin that extends the built-in path repository with additional version metadata detection and tolerant (non-failing) path matching.

1.0.0 2026-06-25 17:09 UTC

Requires

• php: ^8.2
• composer-plugin-api: ^2.9
• composer/semver: ^3.0

Requires (Dev)

• composer/composer: ^2.9
• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

GPL-2.0-or-later

• Stefan Bürk

• path
• composer
• repository
• typo3
• composer-plugin

README

A Composer plugin that extends the built-in path repository with:

• Extended version detection – derive a path package's version from its composer.json version, from extra."typo3/cms".version, or from a sibling VERSION file, before falling back to Composer's stock determination.
• Tolerant path matching – a configured url that matches nothing (a missing directory or an empty glob) is silently ignored instead of aborting the whole Composer run.

The plugin keeps the exact same configuration syntax as the stock path repository ("type": "path"); once installed it transparently upgrades every path repository in your project.

{
    "repositories": [
        { "type": "path", "url": "packages/*" }
    ]
}

Installation

composer require sbuerk/extended-path-repository

Important

Because Composer instantiates repositories before plugins are activated, the plugin must already be installed for its behaviour to apply. Install it first, then add your (extended / tolerant) path repositories – see docs/installation.md and docs/limitations.md.

Requirements

• PHP 8.2+
• Composer 2.9+ (composer-plugin-api: ^2.9)

Documentation

Short overview here – details live in docs/:

• Installation
• Configuration & usage
• Version detection
• How it works (architecture)
• Limitations
• Development & testing

Contributing

Contributions are welcome – please read CONTRIBUTING.md.

License

Released under the GNU General Public License v2.0 or later.