sbuerk/typo3-composer-tools

Composer plugin providing helpful commands around TYPO3 projects, starting with typo3:version.

1.0.0 2026-07-03 11:41 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• composer-plugin-api: ^2.9

Requires (Dev)

• composer/composer: ^2.9
• ergebnis/composer-normalize: ^2.45
• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

GPL-2.0-or-later

• Stefan Bürk

• cli
• composer
• tools
• typo3
• composer-plugin

Published on Packagist.org on 2026-07-03 11:50 UTC

README

# sbuerk/typo3-composer-tools

TYPO3 Composer Tools – a Composer plugin that adds a small set of helpful commands to any project it is installed in. The first command, typo3:version, reports the installed typo3/cms-core version in a plain, script-friendly form.

Requirements

• PHP 8.2, 8.3, 8.4 or 8.5
• Composer 2.9+ (composer-plugin-api: ^2.9)

Installation

composer require sbuerk/typo3-composer-tools

The package is a composer-plugin; once required it registers its commands automatically and they become available through the composer binary.

Usage

typo3:version

Print the currently installed typo3/cms-core version. Prints an empty string when TYPO3 is not installed:

$ composer typo3:version
13.4.21

--extended

Print the version broken down into its parts together with the applied constraint and installation state:

$ composer typo3:version --extended
Current: 13.4.21
Major: 13
Minor: 4
Patchlevel: 21
Constraint: ^13.4.20 || ^14.3.2
Installed: true

--json

Print a single, always-complete JSON document — pipeable straight into tools like jq:

$ composer typo3:version --json
{"current":"13.4.21","major":13,"minor":4,"patchlevel":21,"constraint":"^13.4.20 || ^14.3.2","installed":true}

When TYPO3 is not installed, current, major, minor and patchlevel are null and installed is false:

$ composer typo3:version --json
{"current":null,"major":null,"minor":null,"patchlevel":null,"constraint":null,"installed":false}

Only the requested output is written to stdout, so the result can be consumed by other tools without noise.

Contributing

Contributions are welcome — please read CONTRIBUTING.md.

License

Released under the GNU General Public License v2.0 or later.