PHPackages                             mtk/releaser - 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. mtk/releaser

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

mtk/releaser
============

Generate CHANGELOG.md file from developers changes

0.1.4(5y ago)05MITPHPPHP >=7.4CI failing

Since Sep 18Pushed 4y agoCompare

[ Source](https://github.com/mtk3d/releaser)[ Packagist](https://packagist.org/packages/mtk/releaser)[ RSS](/packages/mtk-releaser/feed)WikiDiscussions master Synced 5d ago

READMEChangelogDependencies (15)Versions (6)Used By (0)

Releaser
========

[](#releaser)

This tool will help releasing and CHANGELOG.md maintaining in git projects.

**This CLI is in test phase!**

Install
=======

[](#install)

```
$ composer require mtk/releaser
```

Usage
=====

[](#usage)

Create new change:

```
$ vendor/bin/releaser new feature "Example change" "ID-543" "John Doe"
```

Available types:

- fix
- feature
- deprecation
- security
- performance
- other

Create new release:

```
$ vendor/bin/releaser release major
```

Available releases:

- major
- minor
- patch

Example usage scenario
----------------------

[](#example-usage-scenario)

```
Feature: Create new change by developer
Background: We have git repository on GitLab, and developer with his own branch

Given branch with uncommited changes
When developer make new change
Then new change file is created
```

```
Feature: Create new release
Background: We have git repository on GitLab, with merged developer's branches to master

Given master branch with unreleased changes
When maintainer release new version
Then changelog file is updated
And new git tag is created
And release is published
```

Configuration defaults
----------------------

[](#configuration-defaults)

```
changesDirectory: .unreleased
changelogName: CHANGELOG.md
git:
  enabled: true
  push: true
  commitMessage: Update changelog
publishers: {}
```

Configure GitLab publisher
--------------------------

[](#configure-gitlab-publisher)

```
publishers:
  class: GitLabPublisherClient
  projectId: 100
  privateToken: DA32HJB2KLH321
  gitlabUrl: https://gitlab.com
```

TODO
----

[](#todo)

- Refactor functional test for DI container usage
- Fix git changes checking
- Add wizard to create change
- Write better docs
- Add more publishers, and test custom publisher
- Replace config library (actual cannot replace only a part of nested array defaults, like only single git parameter)

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

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

Total

5

Last Release

2065d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2fbd2ea901d85029a60d2774f042c1c2a65c429ac3547291e5cadbe2152ec5e7?d=identicon)[mtk3d](/maintainers/mtk3d)

---

Top Contributors

[![mtk3d](https://avatars.githubusercontent.com/u/12657846?v=4)](https://github.com/mtk3d "mtk3d (79 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mtk-releaser/health.svg)

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

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)[acquia/orca

A tool for testing a company's software packages together in the context of a realistic, functioning, best practices Drupal build

32902.4k](/packages/acquia-orca)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

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