voral/laravel-version-increment

Laravel Artisan adapter for vs-version-incrementor — automated versioning and changelog generation based on Git commits.

3.0.0 2025-12-26 09:05 UTC

Requires

• php: >=8.2
• illuminate/console: *
• voral/version-increment: ^3.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.92
• orchestra/testbench: ^10.8
• php-mock/php-mock-phpunit: ^2.14
• phpstan/phpstan: ^2.1
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^11.5

MIT

• Alexander Vorobyev

README

RU

This package provides a native Artisan command for vs-version-incrementor — a tool for automated version management and CHANGELOG.md generation based on Git commit analysis.

Now you can leverage all features of vs-version-incrementor directly from the Laravel console — without manually invoking external scripts.

Installation

Install the package via Composer:

composer require voral/laravel-version-increment --dev

The package is auto-registered thanks to Laravel Package Auto-Discovery.

Usage

After installation, the following Artisan commands become available.

Increment the version:

# Automatically detect the release type (based on Conventional Commits)
php artisan vs-version:increment

# Explicitly specify the version type
php artisan vs-version:increment major
php artisan vs-version:increment minor
php artisan vs-version:increment patch

Preview changes that would be included in the next version and the expected new version — without modifying any files:

# Automatically detect the release type
php artisan vs-version:debug

# Explicitly specify the version type
php artisan vs-version:debug major
php artisan vs-version:debug minor
php artisan vs-version:debug patch

Update CHANGELOG.md and composer.json (if configured), but skip creating the final Git commit and tag:

# Automatically detect the release type
php artisan vs-version:no-commit

# Explicitly specify the version type
php artisan vs-version:no-commit major
php artisan vs-version:no-commit minor
php artisan vs-version:no-commit patch

List all registered commit types and scopes:

php artisan vs-version:list

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Git available in PATH
• voral/version-increment (installed automatically as a dependency)

Configuration

The adapter uses the same configuration file as the original CLI tool.
Create .vs-version-increment.php in your project root to customize:

• rules for determining major/minor/patch increments,
• CHANGELOG.md formatting,
• ignoring untracked files,
• handling squashed commits,
• custom commit types, and more.

See the full documentation: vs-version-incrementor Configuration Guide

Implementation Details

This package is a thin wrapper around the original utility: it invokes ./vendor/bin/vs-version-increment with the appropriate arguments and flags, ensuring full behavioral parity with the standalone CLI tool.

License

MIT. See LICENSE for details.

Depends on: vs-version-incrementor — automated versioning based on Git history.