PHPackages                             phpbb/translation-validator - 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. phpbb/translation-validator

ActiveLibrary

phpbb/translation-validator
===========================

A language package validator for phpBB language packs. Language packs are required to pass the validator when submitted to the language pack database.

1.6.1(7mo ago)88.3k9[1 PRs](https://github.com/phpbb/phpbb-translation-validator/pulls)1GPL-2.0-onlyPHPPHP &gt;=8.1CI passing

Since May 19Pushed 3mo ago16 watchersCompare

[ Source](https://github.com/phpbb/phpbb-translation-validator)[ Packagist](https://packagist.org/packages/phpbb/translation-validator)[ Docs](https://github.com/phpbb/phpbb-translation-validator)[ GitHub Sponsors](https://github.com/phpbb)[ RSS](/packages/phpbb-translation-validator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (5)Versions (24)Used By (1)

phpBB Translation Validator
===========================

[](#phpbb-translation-validator)

With the help of this command line application you are able to validate [phpBB](https://www.phpbb.com) language packs. This application runs on your local machine and can be integrated into a [GitHub](https://www.github.com) repository.

📋Requirements
-------------

[](#requirements)

This tool requires PHP 8.1 or above. In addition it needs several symfony and other packages, which need to be downloaded and installed with [Composer](https://getcomposer.org).

🏗️ Installation
---------------

[](#️-installation)

Clone this repository:

```
git clone https://github.com/phpbb/phpbb-translation-validator.git

```

Install the dependencies with Composer:

```
composer.phar install

```

Create a directory called `4.0` in the root of the Translation Validator. Afterwards download the [British English language pack](http://www.phpbb.com/customise/db/translation/british_english/)and put its content into `4.0/en/`. Do the same with the languages you wish to test. Which leads e.g. to:

```
phpbb-translation-validator/4.0/en/
phpbb-translation-validator/4.0/de/
phpbb-translation-validator/4.0/fr/
phpbb-translation-validator/translation.php

```

⚗️ Validate language packs
--------------------------

[](#️-validate-language-packs)

The simplest way to validate this language packages, is to open a command line tool in the validator directory. Then run this command (the final argument is the language you wish to test and that has already been stored to the `4.0` directory; e.g. `fr` for French):

```
 php translation.php validate fr

```

There are more arguments that can be supplied. For example, suppose you wanted to have your `4.x` directory in a different location, you wanted to explicitly specify phpBB version 4.x (default validation is against 4.0), you wanted to run in safe mode and you wanted to see all notices displayed - you would run this command:

```
 php translation.php validate fr
    --package-dir=/path/to/your/4.0
    --phpbb-version=4.0
    --safe-mode
    --display-notices

```

The `--safe-mode` flag indicates that you want to parse files instead of directly including them. This is useful if you want to run validations on a web server.

If you are missing the English language files for the official Viglink extension, they can be easily donwloaded using this command:

```
php translation.php download --files=phpbb-extensions/viglink --phpbb-version=4.0

```

🛠️ Integration to your Repository
---------------------------------

[](#️-integration-to-your-repository)

In your project you can add phpBB Translation Validator as a dependency:

```
	{
		"require-dev": {
			"phpbb/translation-validator": "2.0.*"
		}
	}

```

Then add a `php vendor/bin/translation.php` call to your workflow.

We use GitHub Actions as a continuous integration server and phpunit for our unit testing.

### 🏠 Local phpunit execution

[](#-local-phpunit-execution)

To run the unit tests locally, use this command:

```
 php vendor/phpunit/phpunit/phpunit tests/

```

🤖 Tests
-------

[](#-tests)

[![GitHub Actions CI](https://github.com/phpbb/phpbb-translation-validator/actions/workflows/phpunit.yaml/badge.svg?branch=master)](https://github.com/phpbb/phpbb-translation-validator/actions/workflows/phpunit.yaml/badge.svg?branch=master)

🧑‍💻 Contributing
----------------

[](#‍-contributing)

If you notice any problems with this application, please raise an issue at the [Github-Repository](https://github.com/phpbb/phpbb-translation-validator/issues).

To submit your own code contributions, please fork the project and submit a pull request at [Github-Repository](https://github.com/phpbb/phpbb-translation-validator/pulls).

When a new version is released, the version number will be updated in `composer.json` and `translation.php`. A new tag will be created and the package will become available at [Packagist](https://packagist.org/packages/phpbb/translation-validator).

📜 License
---------

[](#-license)

[GNU General Public License v2](license.txt)

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance78

Regular maintenance activity

Popularity30

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 56.5% 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 ~230 days

Recently: every ~522 days

Total

19

Last Release

226d ago

PHP version history (5 changes)1.3.0PHP &gt;=5.3.3

1.4.0PHP &gt;=5.6

1.5.0PHP &gt;=5.5.9

1.6.0PHP ~7.4

1.6.1PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/08db6d037c8c3330ffb98ee67491f3b9c25451c22c34603bc880a573151650ba?d=identicon)[nickvergessen](/maintainers/nickvergessen)

![](https://www.gravatar.com/avatar/d06d63660878650ca0eb60f4a1761f8c3d78c76d66d427e0d6d8938d30346413?d=identicon)[Crizzo](/maintainers/Crizzo)

---

Top Contributors

[![nickvergessen](https://avatars.githubusercontent.com/u/213943?v=4)](https://github.com/nickvergessen "nickvergessen (166 commits)")[![Crizz0](https://avatars.githubusercontent.com/u/1311778?v=4)](https://github.com/Crizz0 "Crizz0 (86 commits)")[![battye](https://avatars.githubusercontent.com/u/2110222?v=4)](https://github.com/battye "battye (33 commits)")[![DavidIQ](https://avatars.githubusercontent.com/u/186341?v=4)](https://github.com/DavidIQ "DavidIQ (5 commits)")[![carlo94it](https://avatars.githubusercontent.com/u/218516?v=4)](https://github.com/carlo94it "carlo94it (3 commits)")[![Elsensee](https://avatars.githubusercontent.com/u/1637630?v=4)](https://github.com/Elsensee "Elsensee (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/phpbb-translation-validator/health.svg)

```
[![Health](https://phpackages.com/badges/phpbb-translation-validator/health.svg)](https://phpackages.com/packages/phpbb-translation-validator)
```

###  Alternatives

[sylius/sylius

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

8.4k5.6M647](/packages/sylius-sylius)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M192](/packages/simplesamlphp-simplesamlphp)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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