Composer Translation ValidatorValidate your translation files

A Composer plugin that validates XLIFF, YAML, JSON and PHP translation files for mismatches, duplicates, schema issues and more.

Auto-Detection

Automatically detects and groups related translation files based on naming conventions and directory structure.

Supports XLIFF, YAML, JSON and PHP translation files commonly used in TYPO3, Symfony and Laravel.

Comprehensive validation including mismatch detection, duplicate keys, placeholder consistency, HTML tags and more.

Flexible configuration via PHP, JSON or YAML files. Enable/disable validators and customize thresholds.

Integrates seamlessly into your CI/CD pipeline with JSON and GitHub output formats.

Treat warnings as errors for rigorous validation in production environments.

Install the plugin via Composer:

bash

composer require --dev move-elevator/composer-translation-validator

Validate your translation files:

bash

composer validate-translations ./translations

Console Output

Validator	Type	Description
MismatchValidator	ERROR	Finds missing translations between language files
DuplicateKeysValidator	ERROR	Catches duplicate keys within files
XliffSchemaValidator	ERROR	Validates XLIFF against XML schemas
DuplicateValuesValidator	WARNING	Finds identical translation values (opt-in)
EmptyValuesValidator	WARNING	Detects empty or whitespace-only values
PlaceholderConsistencyValidator	WARNING	Validates placeholder patterns
HtmlTagValidator	WARNING	Ensures HTML tag consistency across languages
EncodingValidator	WARNING	Validates UTF-8 encoding and Unicode issues
KeyCountValidator	WARNING	Warns when files exceed key threshold
KeyDepthValidator	WARNING	Warns about excessive nesting depth
KeyNamingConventionValidator	WARNING	Enforces key naming patterns (opt-in)

See the Validators Reference for detailed documentation.