PHPackages akrabat/changelog-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. akrabat/changelog-generator ActiveLibrary[Utility & Helpers](/categories/utility) akrabat/changelog-generator =========================== Generate Markdown changelogs from your GitHub milestones 3.0.0(4y ago)318BSD-2-ClausePHPPHP ^7.3 || ^8.0 Since Jul 2Pushed 7mo ago1 watchersCompare [ Source](https://github.com/akrabat/changelog_generator)[ Packagist](https://packagist.org/packages/akrabat/changelog-generator)[ RSS](/packages/akrabat-changelog-generator/feed)WikiDiscussions main Synced 3w ago READMEChangelog (1)DependenciesVersions (11)Used By (0) changelog\_generator.php ======================== [](#changelog_generatorphp) This project provides a simple way to create a markdown ordered list of issues and pull requests closed with a given milestone on GitHub. The script ensures that any special characters that might break the generated links are scrubbed and substituted with the corresponding HTML entities; as such, the script should be generally usable unattended. This is a fork of [phly/changelog-generator](https://github.com/weierophinney/changelog_generator) for use with more recent versions of PHP and various quality-of-life improvements. Installation ------------ [](#installation) Use [Composer](https://getcomposer.org) to install dependencies: ``` $ composer require akrabat/changelog-generator ``` This will install the script in `vendor/bin/changelog_generator.php`. You can also install globally using: ``` composer global require akrabat/changelog-generator ``` and ensure that `~/.composer/vendor/bin` is on your PATH. The script is then available using `changelog_generator.php` directly. Usage ----- [](#usage) There are two primary ways to use the generator: - Use CLI options to pass in configuration - Create a configuration file, and pass that to the script The standard CLI options are: - **-t** or **--token**, to pass your GitHub API token - **-u** or **--user**, to pass your GitHub username or organization - **-r** or **--repo**, to pass your GitHub repository name - **-m** or **--milestone**, to pass the identifier of the GitHub milestone for which to generate the changelog As an example: ``` vendor/bin/changelog_generator.php -t MYgithubAPItoken -u weierophinney -r changelog_generator -m 1 > changelog.md ``` Alternately, create a configuration file. You can use `config/config.php.dist`as a template; it simply needs to return an array with the keys "token", "user", "repo", and "milestone". You then pass this to the script: ``` vendor/bin/changelog_generator.php -c path/to/config.php ``` You can also mix-and-match options -- for instance, you might place your token in a configuration file, and then pass the other options via CLI. ### Additional options [](#additional-options) Additional CLI options control the output: - **-g** or **--group-labels**, to display the result grouped by labels - **-o** or **--plain-text-output**, to display the milestone titles as plain text, rather than HTML encoded ### Health Score 38 — LowBetter than 83% of packages Maintenance43 Moderate activity, may be stable Popularity10 Limited adoption so far Community13 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~423 days Recently: every ~526 days Total 8 Last Release 1785d ago Major Versions v1.0.0 → v2.0.02013-07-03 v2.2.0 → 3.0.02021-08-12 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/33135?v=4)[Rob Allen](/maintainers/akrabat)[@akrabat](https://github.com/akrabat) --- Top Contributors [![weierophinney](https://avatars.githubusercontent.com/u/25943?v=4)](https://github.com/weierophinney "weierophinney (37 commits)")[![akrabat](https://avatars.githubusercontent.com/u/33135?v=4)](https://github.com/akrabat "akrabat (24 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (11 commits)")[![mikeSimonson](https://avatars.githubusercontent.com/u/907613?v=4)](https://github.com/mikeSimonson "mikeSimonson (5 commits)")[![asgrim](https://avatars.githubusercontent.com/u/496145?v=4)](https://github.com/asgrim "asgrim (2 commits)")[![joshribakoff](https://avatars.githubusercontent.com/u/4021306?v=4)](https://github.com/joshribakoff "joshribakoff (2 commits)")[![lcobucci](https://avatars.githubusercontent.com/u/201963?v=4)](https://github.com/lcobucci "lcobucci (1 commits)") --- Tags githubchangelog ### Embed Badge ![Health badge](/badges/akrabat-changelog-generator/health.svg) ``` [![Health](https://phpackages.com/badges/akrabat-changelog-generator/health.svg)](https://phpackages.com/packages/akrabat-changelog-generator) ``` ### Alternatives [pyrech/composer-changelogs Display changelogs after each composer update 5904.2M31](/packages/pyrech-composer-changelogs)[marcocesarato/php-conventional-changelog Generate changelogs and release notes from a project's commit messages and metadata and automate versioning with semver.org and conventionalcommits.org 2521.5M119](/packages/marcocesarato-php-conventional-changelog)[jwage/changelog-generator Generate a markdown changelog document from a GitHub milestone. 10374.9k](/packages/jwage-changelog-generator)[unicodeveloper/laravel-emoji A Laravel 5 Package for Using & Working With Emojis 20925.1k](/packages/unicodeveloper-laravel-emoji)[producer/producer Tools for releasing library packages; supports Git, Mercurial, Github, Gitlab, and Bitbucket. 10419.8k3](/packages/producer-producer)[victorybiz/geoip-location Get the geographical location of website visitors based on their IP addresses. Support Laravel and PHP (Non-Laravel) Project. 23167.8k2](/packages/victorybiz-geoip-location) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)