yosymfony / embedded-composer
Embed Composer into another application
Requires
- php: >=5.5
- composer/composer: ^1.3
This package is auto-updated.
Last update: 2024-10-13 04:05:44 UTC
README
Embed Composer into another application. This library is based on dflydev-embedded-composer. Due to this latter seems abandoned, I decided to fork this one and start my own way.
Why Would I Want To Embed Composer?
Imagine a console application shipped as a phar. If it is desired for the
application to be extensible based on which directory it is in (say one set
of plugins should be used in one directory but an entirely different set of
plugins used in another directory) one cannot simply define a composer.json
in both directories and run composer install
.
Why not? Because the application shipped with a specific set of dependencies.
Composer cannot add more dependencies without running the risk of introducing
conflicts. The answer is to embed Composer into the application so that
Composer can merge the dependencies already installed for the application
with the dependencies defined in a specific directory's composer.json
.
The end result is a set of dependencies that satisfy the directory specific requirements while taking into account the dependencies already installed for the console application.
While this is required for a phar distributed application this technique can be applied to any globally installed application that needs to be runtime extensible.
Usage
Basics
The following is an example bin/myapp
style script that can be used either
installed via Composer (vendor/bin/myapp
) or installed globally
(/usr/local/bin/myapp
).
myapp.php (bin)
A shared block of code to initialize Embedded Composer from an application.
// assume $classLoader is somehow defined prior to this block of // code and contains the Composer class loader from the command // // see next two blocks of code use Yosymfony\EmbeddedComposer\EmbeddedComposerBuilder; $input = new ArgvInput; $projectDir = '/my-project-dir' $embeddedComposerBuilder = new EmbeddedComposerBuilder( $classLoader, $projectDir ); $embeddedComposer = $embeddedComposerBuilder ->setComposerFilename('composer.json') ->setVendorDirectory('.vendor') ->build(); $embeddedComposer->processAdditionalAutoloads(); // application is now ready to be run taking both the embedded // dependencies and directory specific dependencies into account.
myapp (bin)
Example bin script (bin/myapp
) that requires the shared block of code
after it locates the correct autoloader.
#!/usr/bin/env php <?php if ( // Check where autoload would be if this is myapp included // as a dependency. (!$classLoader = @include __DIR__.'/../../../autoload.php') and // Check where autoload would be if this is a development version // of myapp. (based on actual file) (!$classLoader = @include __DIR__.'/../vendor/autoload.php') ) { die('You must set up the project dependencies, run the following commands: composer install '); } include('myapp.php');
myapp-phar-stub (bin)
Example phar stub (bin/myapp-phar-stub
) that can be used to bootstrap
a phar application prior to requiring the shared block of code.
#!/usr/bin/env php <?php if (!$classLoader = @include __DIR__.'/../vendor/autoload.php') { die ('There is something terribly wrong with your archive. Try downloading it again?'); } include('myapp.php');
What else ...
Find installed package by name
One can search for any package that Composer has installed by using
the findPackage
method:
$package = $embeddedComposer->findPackage('acme/myapp');
Create a Composer instance
use Composer\IO\BufferIO; // requires creating an IOInterface instance such as BufferIO $io = new BufferIO(); $composer = $embeddedComposer->createComposer($io);
Create a Composer Installer instance
The Installer instance is suitable for processing install
and update
operations against the external configuration. It will take the internal
(embedded) configuration into account when solving dependencies.
use Composer\IO\BufferIO; $io = new BufferIO(); $composer = $embeddedComposer->createComposer($io); $installer = $embeddedComposer->createInstaller($composer, $io);