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.