auroro/composer

Composer script resolution utilities

v0.5.0 2026-03-16 08:44 UTC

Requires

• php: >=8.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3
• pestphp/pest: ^4
• pestphp/pest-plugin-type-coverage: ^4
• phpstan/phpstan: ^2

MIT

README

Composer script resolution utilities for PHP.

Installation

composer require auroro/composer

Usage

ScriptResolver resolves Composer script references (@ prefixes) into executable shell commands.

use Auroro\Composer\ScriptResolver;

$resolver = new ScriptResolver(
    scripts: [
        'test' => 'vendor/bin/pest',
        'check' => ['@test', '@php vendor/bin/phpstan analyse'],
    ],
    bin: ['bin/lens'],
);

$resolver->resolve('@test');              // "vendor/bin/pest"
$resolver->resolve('@check');             // "vendor/bin/pest && php vendor/bin/phpstan analyse"
$resolver->resolve('@lens audit');        // "bin/lens audit"
$resolver->resolve('@putenv APP_ENV=ci'); // "export APP_ENV=ci"

Supported prefixes

Prefix	Resolves to
@php	php
@composer	composer
@putenv KEY=VAL	export KEY=VAL
@binname	Matching bin entry path
@scriptname	Recursive script resolution

Composer callbacks (ClassName::method) and modifier directives (@no_additional_args) are automatically stripped.

License

MIT