shipfastlabs/link

Link local packages for development by modifying composer.json and composer.lock

v1.0.3 2026-02-12 08:04 UTC

Requires

• php: ^8.2.0
• composer-plugin-api: ^2.6

Requires (Dev)

• composer/composer: ^2.6
• laravel/pint: ^1.24.0|^3.0
• peckphp/peck: ^0.1.3
• pestphp/pest: ^3.0|^4.1.0
• pestphp/pest-plugin-type-coverage: ^3.0|^4.0.2
• phpstan/phpstan: ^2.1.26
• rector/rector: ^2.1.7
• symfony/var-dumper: ^7.3.3

MIT

• php
• composer
• link
• development
• symlink

README

Link

Link local packages for development by modifying composer.json and composer.lock.

Requires PHP 8.2+ and Composer 2.6+

Installation

Install globally so it's available in all your projects:

composer global require shipfastlabs/link

Or install per-project:

composer require shipfastlabs/link --dev

Usage

Link a local package

composer link ../packages/my-package

This will:

• Add a path repository entry to your composer.json
• Update the require constraint to * so Composer resolves from the local path
• Run composer update to update composer.lock and symlink the package

Link multiple packages with wildcards

composer link ../packages/*

Only link packages that are already in your composer.lock:

composer link ../packages/* --only-installed

List linked packages

composer linked

Unlink a package

composer unlink ../packages/my-package

This restores the original version constraint in composer.json and runs composer update to install the released version from Packagist.

Unlink all packages

composer unlink-all

How it works

Unlike composer-link which works in-memory, this plugin modifies your composer.json and composer.lock files directly:

1. composer link adds a path repository to composer.json and runs composer update
2. composer unlink removes the path repository, restores the original constraint, and runs composer update
3. Original version constraints are tracked in vendor/composer-link.json so they can be restored on unlink
4. Both require and require-dev packages are supported

Development

composer lint        # Format code with Pint
composer refactor    # Run Rector refactors
composer test:types  # Static analysis with PHPStan
composer test:unit   # Unit tests with Pest
composer test        # Run the entire test suite

License

Link is open-sourced software licensed under the MIT license.