codebymikey/composer-vendor-patch

Provides a Composer plugin to generate patches based on local changes to a vendor package.

dev-main 2025-10-17 12:25 UTC

Requires

• composer-plugin-api: ^2.0
• symfony/process: ^5.0 || ^6.0

Requires (Dev)

• composer/composer: ^2.8
• mikey179/vfsstream: ^1.6
• phpunit/phpunit: ^12.4

MIT

• codebymikey

README

Composer vendor patch is a composer plugin that allows users to easily generate patches based on local changes to a vendor package.

The idea is to use the generated patches in tandem with the composer-patches plugin.

How to Use

Simply run composer generate-vendor-patches <package-name...> and the patches for said package should be generated.

Configuration

The default plugin configurations are as follows:

{
  // composer.json
  "extra": {
    "composer-vendor-patch": {
      "patch-dir": "patches",
      "patch-format": "{vendor}__{name}.diff"
    }
  }
}

Where patch-dir and patch-format supports the following placeholders:

• {vendor} - The package vendor namespace.
• {name} - The package name.
• {version} - The package version.
• {type} - The type of the package.
• {sourceReference} - The source reference (may be empty).
• {distReference} - The dist reference (may be empty).
• {distSha1Checksum} - The dist sha1 reference (may be empty).

However, these configurations may be overridden for specific packages if necessary:

{
  // composer.json
  "extra": {
    "composer-vendor-patch": {
      "patch-dir": {
        "vendor/package-1": "patches",
        "vendor/package-2": "second-patches-dir/${vendor}",
      },
      "patch-format": {
        "vendor/package-1": "{vendor}__{name}.diff"
      }
    }
  }
}