PHPackages                             vbuck/magento-module-bundler - 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. [Utility & Helpers](/categories/utility)
4. /
5. vbuck/magento-module-bundler

ActiveLibrary[Utility & Helpers](/categories/utility)

vbuck/magento-module-bundler
============================

Module bundling utility. Bundles Magento modules from Composer vendor spaces into ZIP artifacts.

1.4.0(3y ago)1413MITPHPPHP >=7.0

Since Dec 8Pushed 3y agoCompare

[ Source](https://github.com/vbuck/magento-module-bundler)[ Packagist](https://packagist.org/packages/vbuck/magento-module-bundler)[ RSS](/packages/vbuck-magento-module-bundler/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

Magento Module Bundler Utility
==============================

[](#magento-module-bundler-utility)

Bundles Magento modules from Composer vendor spaces into ZIP artifacts.

In some cases, a module must be installed using the `app/code` space, even though it is only configured for Composer based installation. This utility helps to bundle one or more Composer packages into a single ZIP archive.

Use Cases
---------

[](#use-cases)

- Offering multiple options for installation without manual packaging effort.
- Creating bundles of modules from one or more Composer packages for distribution.

This tool was built to support automated bundling of multiple Composer packages from a meta-package.

Installation
------------

[](#installation)

Works as a Composer package to load with your project:

```
composer config repositories.magento-module-bundler vcs https://github.com/vbuck/magento-module-bundler.git
composer require vbuck/magento-module-bundler:*

```

Or you can download the standalone CLI tool:

```
wget https://raw.githubusercontent.com/vbuck/magento-module-bundler/main/bin/module-bundler
chmod +x module-bundler
sudo mv module-bundler /usr/local/bin/

```

How to Use
----------

[](#how-to-use)

Example scenario:

1. I need to install a module into `app/code` but it only installs via Composer.
2. To perform this action, I first need use Composer to download the package.
3. I must then copy its content into the `app/code` space using the correct vendor and module name as a path.
4. I must then remove the original copy from the vendor space, and optionally clean my Composer files.
5. I can optionally bundle the moved contents into a ZIP archive for distribution.

I want to automate this process using a single command.

### Code Sample

[](#code-sample)

```
$instance = new \Vbuck\MagentoModuleBundler\Bundler('/path/to/magento/root');
$result = $instance->bundle(
    [
        'vendor/package1',
        'vendor/package2',
        '/path/to/other/package',
        'package-*',
    ],
    '/path/to/output',
    \Vbuck\MagentoModuleBundler\Bundler::BEHAVIOR_INDIVIDUAL_BUNDLES, // or BEHAVIOR_SINGLE_BUNDLE
    \Vbuck\MagentoModuleBundler\Bundler::OUTPUT_TYPE_MAGENTO // or OUTPUT_TYPE_COMPOSER
);

if ($result[0]->state === true) {
 echo "Module {$result[0]->name} has been bundled";
}

```

### Command-Line Usage

[](#command-line-usage)

```
bin/module-bundler --app-root=/path/to/magento \
    --package=/path/to/magento/root \
    --package=vendor/package1 \
    --package=/path/to/other/package \
    --package=package-*
    --single-bundle
    --output-path=/path/to/bundles

Options:
    --app-root[=PATH]       Optional path to a Magento installation. Defaults to current working directory.
    --output-path[=PATH]    Optional path to write your bundles. Defaults to current working directory.
    --package[=SEARCH]      A search string for a package. Can be absolute, relative, package name, wildcard.
    --single-bundle         Optional flag to bundle all matching packages into a single artifact.
    --composer-artifact     Optional flag to output the bundle as a Composer artifact instead of a Magento bundle.

```

Architectural Principles
------------------------

[](#architectural-principles)

- Simple: low complexity, few dependencies, "gistable" deployment
- Flexible: can use in a project or as a standalone utility

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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 ~56 days

Total

4

Last Release

1444d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1f4e59c04445e07d9b52456fc330e14ee6b4445f56a9744bb337a4555a0594de?d=identicon)[vbuck](/maintainers/vbuck)

---

Top Contributors

[![vbuck](https://avatars.githubusercontent.com/u/4059757?v=4)](https://github.com/vbuck "vbuck (10 commits)")

### Embed Badge

![Health badge](/badges/vbuck-magento-module-bundler/health.svg)

```
[![Health](https://phpackages.com/badges/vbuck-magento-module-bundler/health.svg)](https://phpackages.com/packages/vbuck-magento-module-bundler)
```

###  Alternatives

[geniusts/laravel-hijri-dates

Hijri dates package for Laravel

2722.5k](/packages/geniusts-laravel-hijri-dates)[elaniin/findable

An SEO add-on for Statamic.

131.4k](/packages/elaniin-findable)

PHPackages © 2026

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