PHPackages                             blackbird/magento-quality-patches-applier - 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. [Testing &amp; Quality](/categories/testing)
4. /
5. blackbird/magento-quality-patches-applier

ActiveComposer-plugin[Testing &amp; Quality](/categories/testing)

blackbird/magento-quality-patches-applier
=========================================

A Composer plugin that manages the application of patches from magento/quality-patches

1.0.2(2mo ago)28.0k↓63.3%MITPHPPHP &gt;=7.3

Since Oct 3Pushed 2mo agoCompare

[ Source](https://github.com/blackbird-agency/magento-quality-patches-applier)[ Packagist](https://packagist.org/packages/blackbird/magento-quality-patches-applier)[ RSS](/packages/blackbird-magento-quality-patches-applier/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)Dependencies (6)Versions (4)Used By (0)

Magento Quality Patches Applier
===============================

[](#magento-quality-patches-applier)

[![Latest Stable Version](https://camo.githubusercontent.com/6541b99fab39a9edacba53f625ce6b2d95d782443beddd5c04b1846e982f2d5a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c61636b626972642f6d6167656e746f2d7175616c6974792d706174636865732d6170706c6965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/blackbird/magento-quality-patches-applier)[![License: MIT](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](./LICENSE)

A Composer plugin that manages the application of patches from magento/quality-patches.

The free source is available at the GitHub repository of this project.

What it does
------------

[](#what-it-does)

This Composer plugin hooks into install/update commands to automatically revert previously applied Magento Quality Patches and apply the ones you request, using the magento/quality-patches CLI under the hood.

- Before install/update: it reverts all currently applied patches (safety to avoid conflicts).
- After install/update: it applies the patches you configured.

It relies on the magento/quality-patches package binary (vendor/bin/magento-patches) and your composer.json "extra" configuration.

Requirements
------------

[](#requirements)

- PHP &gt;= 7.3
- Composer (Plugin API ^1.0 or ^2.0)
- magento/quality-patches (this package requires it)
- A Magento project (the patches are intended for Magento)

Setup
-----

[](#setup)

### Get the package

[](#get-the-package)

Composer Package:

```
composer require blackbird/magento-quality-patches-applier

```

This will also install magento/quality-patches if it is not already present.

### Configure patches to apply

[](#configure-patches-to-apply)

In your project composer.json, define the patches you want in the extra.magento-patches.apply section. You can also list patches to ignore.

Example:

```
{
  "extra": {
    "magento-patches": {
      "apply": [
        "AC-1234",
        "MC-5678"
      ],
      "ignore": [
        "MDVA-99999"
      ]
    }
  }
}

```

Special values for apply:

- "all", "\*", or "ALL" applies all patches that are currently "Not applied" according to the status command.

Environment/config flags:

- Set environment variable COMPOSER\_EXIT\_ON\_MAGENTO\_PATCH\_FAILURE=1 (or add extra.composer-exit-on-magento-patch-failure: true) to make Composer fail if patch application fails.

### Install / Update

[](#install--update)

Run your usual Composer commands from your project root:

```
composer install
# or
composer update

```

The plugin will:

1. Revert applied patches before the command runs.
2. Apply requested patches after dependencies are resolved.

If you enable verbose Composer output (-vvv), the plugin will display the exact magento-patches commands it executes.

How it works
------------

[](#how-it-works)

Internally, the plugin subscribes to Composer script events:

- pre-install-cmd, pre-update-cmd: revertPatches
- post-install-cmd, post-update-cmd: applyPatches

It uses the magento-patches binary to retrieve status (JSON), revert --all, and apply the requested patch IDs. If the magento-patches binary is not found under Composer’s bin-dir, the plugin will fail with a clear message.

Troubleshooting
---------------

[](#troubleshooting)

- magento-patches binary not found

    - Ensure magento/quality-patches is installed and composer’s bin-dir (typically vendor/bin) contains magento-patches. Re-run composer install.
- Patch application fails

    - Re-run with -vvv for details.
    - Set COMPOSER\_EXIT\_ON\_MAGENTO\_PATCH\_FAILURE=1 to let Composer stop on failures.
    - Check for local changes conflicting with patches. Consider reverting changes or adjusting ignore/apply lists.
- No patches applied

    - Verify extra.magento-patches.apply is set and not empty. Use "all" to apply all not-yet-applied patches.

Support
-------

[](#support)

- If you have any issue with this code, feel free to open an issue on your project tracker or contact Blackbird.
- Contributions are welcome. Please open a pull request.

Contact
-------

[](#contact)

For further information, contact Blackbird:

- by email:
- by form:

Authors
-------

[](#authors)

From Blackbird Team ()

License
-------

[](#license)

This project is licensed under the MIT License - see the LICENSE file for details.

That's all folks!

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance85

Actively maintained with recent releases

Popularity28

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~97 days

Total

3

Last Release

80d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12445118?v=4)[anthony-blackbird](/maintainers/anthony-blackbird)[@anthony-blackbird](https://github.com/anthony-blackbird)

---

Top Contributors

[![bruno-blackbird](https://avatars.githubusercontent.com/u/77049160?v=4)](https://github.com/bruno-blackbird "bruno-blackbird (3 commits)")

### Embed Badge

![Health badge](/badges/blackbird-magento-quality-patches-applier/health.svg)

```
[![Health](https://phpackages.com/badges/blackbird-magento-quality-patches-applier/health.svg)](https://phpackages.com/packages/blackbird-magento-quality-patches-applier)
```

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)[dealerdirect/phpcodesniffer-composer-installer

PHP\_CodeSniffer Standards Composer Installer Plugin

601175.5M2.4k](/packages/dealerdirect-phpcodesniffer-composer-installer)[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M1.0k](/packages/symfony-runtime)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5445.2M565](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M203](/packages/drupal-core-project-message)[codeception/c3

CodeCoverage collector for Codeception

745.6M64](/packages/codeception-c3)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
