PHPackages comodojo/composer-events-handler - 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. comodojo/composer-events-handler AbandonedArchivedComposer-plugin comodojo/composer-events-handler ================================ 24[1 issues](https://github.com/comodojo/composer-events-handler/issues)PHP Since Apr 19Pushed 9y ago2 watchersCompare [ Source](https://github.com/comodojo/composer-events-handler)[ Packagist](https://packagist.org/packages/comodojo/composer-events-handler)[ RSS](/packages/comodojo-composer-events-handler/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) composer-events-handler ======================= [](#composer-events-handler) This package contains a [Composer Plugin](https://getcomposer.org/doc/articles/plugins.md) that allows you to create installation procedures that will be executed during the `composer install` or `composer update`. Why do you need this plugin? ---------------------------- [](#why-do-you-need-this-plugin) If you're an avid Composer user, you'll probably know that you can add post installation scripts in your project `composer.json`, but you can't do the same with every child package because... reasons. Well, to be fair, this is not natively implemented in Composer because of the security problems it can leads to, but there are times, when you work in a controlled environment and you're trying to organize the development process between various workgroups, that you'll find the need to be able to initialize your packages right after the installation. You may need to initialize the database, creating tables, setting up variables or creating folders under your installation path. Whatever you're up to, this sort of things should be done before the code is executed for the first time. This is why you need this plugin. Installation ------------ [](#installation) Install [composer](https://getcomposer.org/), then: `composer require comodojo/composer-events-handler 0.0.*` How to make it work ------------------- [](#how-to-make-it-work) This package is implemented as a [Composer Plugin](https://getcomposer.org/doc/articles/plugins.md). This means you can't manually execute this code. It will be loaded by the composer itself after every installation or update. After you've installed this plugin in your main project, in order to make it work, you need to follow this two steps in your child package: ### Step 1: Create a Setup Class [](#step-1-create-a-setup-class) You need to create a class in your package that extends the abstract class `\Comodojo\Composer\EventsHandler` implementing one or more of the following methods: ``` public function install() {} // Called after the installation of the package (including root package) public function update() {} // Called after the package has been updated public function uninstall() {} // Called before the package is uninstalled (you can use it to clean up) public function finalize() {} // Always called after composer has finished doing its job (install, update, create-project) ``` For example: ``` namespace MyProject\MyApp; class MyAppSetup extends \Comodojo\Composer\EventsHandler { public function finalize() { // Do awesome stuff } } ``` ### Step 2: Add the install information to your `composer.json` [](#step-2-add-the-install-information-to-your-composerjson) When your Setup Class is ready, you need to reference it into the `composer.json` of your package. Under the `extra` field you need to create an array called `composer-events-handler` which lists all the Setup Classes you created (yep, you can create as much as you like) ``` { "extra": { "composer-events-handler": [ "MyProject\\MyApp\\MyAppSetup" ] } } ``` The procedures will be executed in the same order they are listed into the `composer-events-handler` array. How to handle dependencies between packages ------------------------------------------- [](#how-to-handle-dependencies-between-packages) When you work on a big project with a lot of packages, it can happens that your Setup Class depends on informations or files created by another package. Sadly, the Composer framework doesn't allow us to know in which order the various classes will be executed. Basically, you can control the order of execution within a package, but you don't know which package will be installed first. This is because updated or new packages catch the update event before the other packages. The best practice should be to not create dependencies between packages at all but, let's be honest, this is quite impossible. The handling of this issue is quite completely demanded to your coding skills, but in order to help you, we introduced the method `retry()`. You can put all your code that depends on other packages within one or more methods of your Setup Class and then call them through the `retry()` method. ``` namespace MyProject\MyApp; class MyAppSetup extends \Comodojo\Composer\EventsHandler { public function install() { // Do awesome stuff $this->retry("doStuff"); } public function doStuff() { // load an object that may be installed by another package try { $obj = new MyOtherPackageObject(); $obj->doSomethingAwesome(); } catch (\Exception $e) { throw $e; } } } ``` If the execution of those methods fails, the whole package will be added to a queue of failed executions. When all the installations are completed, all the failed setups will be executed again. Of course, the execution can fail again. The reasons can be as follows: - The execution failed because of coding errors (check the log file for a list of error messages) - The package depends on another package whose installation also failed If the latter is the case, you can try running the `composer update` again. The log file ------------ [](#the-log-file) In order to keep things clean, this plugin prints just few information on the screen. It tells you which package is installing and if the execution has been completed or it's failed. If you want to know what's been wrong with your installation, all the exception messages are stored in a log file. By default this log is set as `./composer-events.log`, but you're able to configure it as you like it by editing the `composer.json` of your root package (the project) as follows: ``` { "extra": { "composer-events-log": "./path-to-my-file.log" } } ``` Contributing ------------ [](#contributing) Contributions are welcome and will be fully credited. Please see [CONTRIBUTING](CONTRIBUTING.md) for details. License ------- [](#license) `comodojo/composer-events-handler` is released under the MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 18 — LowBetter than 8% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community10 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 66.7% of commits — single point of failure 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/4cc933c2d1b92f7fd32abb459387bff69fc8a87158b1474171ccf26139904706?d=identicon)[comodojo](/maintainers/comodojo) --- Top Contributors [![mcastiello](https://avatars.githubusercontent.com/u/12670283?v=4)](https://github.com/mcastiello "mcastiello (2 commits)")[![marcogiovinazzi](https://avatars.githubusercontent.com/u/12754673?v=4)](https://github.com/marcogiovinazzi "marcogiovinazzi (1 commits)") ### Embed Badge ![Health badge](/badges/comodojo-composer-events-handler/health.svg) ``` [![Health](https://phpackages.com/badges/comodojo-composer-events-handler/health.svg)](https://phpackages.com/packages/comodojo-composer-events-handler) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)