PHPackages                             mscharl/changelog - 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. mscharl/changelog

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

mscharl/changelog
=================

A changelog generator inspired by the Gitlab CE tools.

1.1.0(6y ago)027[2 PRs](https://github.com/mscharl/changelog-generator/pulls)MITPHP

Since Oct 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mscharl/changelog-generator)[ Packagist](https://packagist.org/packages/mscharl/changelog)[ RSS](/packages/mscharl-changelog/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (5)Used By (0)

mscharl/changelog
=================

[](#mscharlchangelog)

[![Work in Progress](https://camo.githubusercontent.com/70c07a4149353729f2c037fe549ccb8e980ccb59a90b877116dd980d60c14c45/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696e74656e616e63652d5749502d696e666f726d6174696f6e616c)](https://camo.githubusercontent.com/70c07a4149353729f2c037fe549ccb8e980ccb59a90b877116dd980d60c14c45/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696e74656e616e63652d5749502d696e666f726d6174696f6e616c)

This package is inspired by the [Gitlab changelog tools](https://docs.gitlab.com/ce/development/changelog.html). It's stripped down to fit the workflow and requirements of most of my projects.

Creating a changelog entry
--------------------------

[](#creating-a-changelog-entry)

A new line for the changelog is created for each file found in your configured `unreleased_dir`.

The file is created like this:

```
type: 'FEATURE'
title: 'We added a new command to dynamically create changelog lines to avoid merge conflicts between feature branches.'
ticket_id: 717
ticket_url: 'https://my-ticket.system/ticket/7f7241a2-b9ce-4218-9187-ddc58782ba37'
merge_request_id: 6615
other:
    - 'POST DEPLOY: Enable the command in the Pipeline for the `develop` branch'
```

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

[](#installation)

```
composer require mscharl/changelog
```

Add the [configuration](#configuration) and [entry template](#entry-template) as required.

Configuration
-------------

[](#configuration)

To configure the generator you can put a `.changelog.yaml` into you project root.

```
# The path to the changes file that will be generated.
# Should be relative to the project root.
changes_file: 'CHANGES.md'

# The directory path where all unreleased entries are located.
# Should be relative to the project root.
unreleased_dir: 'changelog/unreleased'

# Can be a path to a twig template or a string with placeholders.
entry_template: '/templates/entry.md.twig'
```

Entry Template
--------------

[](#entry-template)

The Template is rendered by the [Twig](https://twig.symfony.com) template engine.

In the config file you can configure either a string or path to a twig file. Both methods are handled the same way.

The [entry files](#creating-a-changelog-entry) properties are passed as variables to Twig.

**Note:** You can't reference any external files within your entry template.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 95% 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 ~7 days

Total

2

Last Release

2449d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7af58327f55f1ab0dc0316078598b84b7f1831b8fc00326804078c3888b2f5e0?d=identicon)[mscharl](/maintainers/mscharl)

---

Top Contributors

[![mscharl](https://avatars.githubusercontent.com/u/1411972?v=4)](https://github.com/mscharl "mscharl (19 commits)")[![friemt](https://avatars.githubusercontent.com/u/42875968?v=4)](https://github.com/friemt "friemt (1 commits)")

### Embed Badge

![Health badge](/badges/mscharl-changelog/health.svg)

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

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M521](/packages/shopware-core)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9317.2k55](/packages/open-dxp-opendxp)[chameleon-system/chameleon-base

The Chameleon System core.

1027.9k4](/packages/chameleon-system-chameleon-base)[forumify/forumify-platform

122.0k12](/packages/forumify-forumify-platform)

PHPackages © 2026

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