PHPackages                             finaldream/packages-generator - 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. finaldream/packages-generator

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

finaldream/packages-generator
=============================

Simple packages.json generator for Composer

1.0.0(6y ago)017MITPHP

Since Jan 11Pushed 6y ago1 watchersCompare

[ Source](https://github.com/finaldream/packages-generator)[ Packagist](https://packagist.org/packages/finaldream/packages-generator)[ Docs](https://github.com/finaldream/packages-generator)[ RSS](/packages/finaldream-packages-generator/feed)WikiDiscussions master Synced 4d ago

READMEChangelogDependenciesVersions (2)Used By (0)

packages-generator
==================

[](#packages-generator)

Simple packages.json generator for Composer

Converts a directory of archives automagically into a custom Composer repository.

Supports hosting a number of pre-packaged archives and expose them via package.json as repository.

Use-Cases:

- i.e. provide 3rd-party Plugins or Themes to a composer-based Wordpress set-up.
- host any pre-packged archives and generate simple package-definitions.

Usage
-----

[](#usage)

```
PHP: php packages-generator.php [options]
Bin: packages-generator [options]

    --dir=            path of repository
    --ext=      Default "zip", overrides extensions (comma-separated)
    --baseurl=         Public URL where the repository will be hosted
    --package-type=   Optional, adds "type" field to package (i.e. "wordpress-plugin")
    --dry-run               Don\'t write packages.json
    --verbose               output generated structure

```

Create a directory containing Zip-files, which will be served as packages. In order to extract relevant information like name and version, the files needs to be named in a certain way:

```
name@version.zip

i.e. special-wordpress-plugin@1.2.3.zip
i.e. namespace/special-wordpress-plugin@1.2.3.zip

```

package can be name-spaced by putting them into folders.

Implementation
--------------

[](#implementation)

Possible ways to implement this script

### Manual

[](#manual)

- manage the archives locally, run the script manually and upload everything via FTP

### Cronjob

[](#cronjob)

- Upload files to a Webhost
- generate packages.json via cronjob

### CI Pipeline

[](#ci-pipeline)

- create CI pipeline on your provider of choice
- manage the archives via git
- run the pipeline on git-push
- generate packages.json
- publish to S3

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

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

Unknown

Total

1

Last Release

2315d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/907d48a6285da81817170c8fca49bb0ec44ba6f0683be590deb2f7c245575aa6?d=identicon)[finaldream](/maintainers/finaldream)

---

Top Contributors

[![olivererdmann](https://avatars.githubusercontent.com/u/1032592?v=4)](https://github.com/olivererdmann "olivererdmann (2 commits)")

---

Tags

composerziprepositorypackagespackages.json

### Embed Badge

![Health badge](/badges/finaldream-packages-generator/health.svg)

```
[![Health](https://phpackages.com/badges/finaldream-packages-generator/health.svg)](https://phpackages.com/packages/finaldream-packages-generator)
```

###  Alternatives

[composer/satis

Simple Repository Generator

3.3k1.4M17](/packages/composer-satis)[jean85/pretty-package-versions

A library to get pretty versions strings of installed dependencies

1.3k289.5M63](/packages/jean85-pretty-package-versions)[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k37.3M2.1k](/packages/ergebnis-composer-normalize)[bamarni/composer-bin-plugin

No conflicts for your bin dependencies

52722.0M859](/packages/bamarni-composer-bin-plugin)[composer/metadata-minifier

Small utility library that handles metadata minification and expansion.

181115.0M13](/packages/composer-metadata-minifier)[shipmonk/composer-dependency-analyser

Fast detection of composer dependency issues (dead dependencies, shadow dependencies, misplaced dependencies)

6076.7M435](/packages/shipmonk-composer-dependency-analyser)

PHPackages © 2026

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