PHPackages                             wickedone/phrase-tag-bundle - 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. [Localization &amp; i18n](/categories/localization)
4. /
5. wickedone/phrase-tag-bundle

ActiveSymfony-bundle[Localization &amp; i18n](/categories/localization)

wickedone/phrase-tag-bundle
===========================

helpers to deal with your phrase translations

4.0.0(5mo ago)19.3k↓43.2%1[1 issues](https://github.com/wickedOne/phrase-tag-bundle/issues)MITPHPPHP ~8.4.0 || ~8.5.0CI passing

Since Dec 30Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/wickedOne/phrase-tag-bundle)[ Packagist](https://packagist.org/packages/wickedone/phrase-tag-bundle)[ RSS](/packages/wickedone-phrase-tag-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (15)Used By (0)

phrase-tag-bundle
=================

[](#phrase-tag-bundle)

providing some commands &amp; services to help you manage your translation keys at phrase. this might be especially useful when you switched to using the [phrase translation provider](https://github.com/wickedOne/phrase-translation-provider).

[![Mutation testing badge](https://camo.githubusercontent.com/307d9eb3690e855efaaae58e24d6743270bb94eb9265fb4015f0ad0c5bdc07fc/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d2532467769636b65644f6e652532467068726173652d7461672d62756e646c652532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/wickedOne/phrase-tag-bundle/master)[![codecov](https://camo.githubusercontent.com/42d378a121ebbf2349929511261fedab558967be69efd916b42abd09e0040ea7/68747470733a2f2f636f6465636f762e696f2f67682f7769636b65644f6e652f7068726173652d7461672d62756e646c652f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d55484b41564755525037)](https://codecov.io/gh/wickedOne/phrase-tag-bundle)[![Latest Stable Version](https://camo.githubusercontent.com/3522d3512435b0daebe5ceb0a8e729f3a3d135307e804c1df50e04e480132f12/68747470733a2f2f706f7365722e707567782e6f72672f7769636b65646f6e652f7068726173652d7461672d62756e646c652f76)](https://packagist.org/packages/wickedone/phrase-tag-bundle)[![Total Downloads](https://camo.githubusercontent.com/63bec1c02d53599dc1e836d7fb633fc64d6c4c1601181d3db979f32e1b9f3b79/68747470733a2f2f706f7365722e707567782e6f72672f7769636b65646f6e652f7068726173652d7461672d62756e646c652f646f776e6c6f616473)](https://packagist.org/packages/wickedone/phrase-tag-bundle)[![License](https://camo.githubusercontent.com/a1e5c7f074e489ffb47d06dbb4d31536afd318413e5b121f5afb81a673cd41da/68747470733a2f2f706f7365722e707567782e6f72672f7769636b65646f6e652f7068726173652d7461672d62756e646c652f6c6963656e7365)](https://packagist.org/packages/wickedone/phrase-tag-bundle)[![PHP Version Require](https://camo.githubusercontent.com/4b6e0c72b7ea3c496164254925039713c24ee5ef3a3b3ea88a463bb55bd5c92e/68747470733a2f2f706f7365722e707567782e6f72672f7769636b65646f6e652f7068726173652d7461672d62756e646c652f726571756972652f706870)](https://packagist.org/packages/wickedone/phrase-tag-bundle)

Installation
------------

[](#installation)

Make sure Composer is installed globally, as explained in the [installation chapter](https://getcomposer.org/doc/00-intro.md)of the Composer documentation.

### Applications that use Symfony Flex

[](#applications-that-use-symfony-flex)

Open a command console, enter your project directory and execute:

```
composer require wickedone/phrase-tag-bundle
```

### Applications that don't use Symfony Flex

[](#applications-that-dont-use-symfony-flex)

#### Step 1: Download the Bundle

[](#step-1-download-the-bundle)

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

```
composer require wickedone/phrase-tag-bundle
```

#### Step 2: Enable the Bundle

[](#step-2-enable-the-bundle)

Then, enable the bundle by adding it to the list of registered bundles in the `config/bundles.php` file of your project:

```
// config/bundles.php

return [
    // ...
    WickedOne\PhraseTagBundle\WickedOnePhraseTagBundle::class => ['all' => true],
];
```

#### step 3: configuration

[](#step-3-configuration)

in your `config/packages` directory create a `wickedone.yaml` file with the following content:

```
wicked_one_phrase_tag:
  dsn: '%env(PHRASE_DSN)%'
```

and in your `.env` file define the phrase dsn like so

```
PHRASE_DSN=phrase://PROJECT_ID:API_TOKEN@default?userAgent=myProject
```

##### dsn elements

[](#dsn-elements)

- `PROJECT_ID`: can be retrieved in phrase from `project settings > API > Project ID`
- `API_TOKEN`: can be created in your [phrase profile settings](https://app.phrase.com/settings/oauth_access_tokens)
- `default`: endpoint, defaults to `api.phrase.com`

##### dsn query parameters

[](#dsn-query-parameters)

- `userAgent`: please read [this](https://developers.phrase.com/api/#overview--identification-via-user-agent) for some examples.

Commands
--------

[](#commands)

After installation two new commands will be available to your application:

### `phrase:keys:tag` command

[](#phrasekeystag-command)

this command helps you to batch tag keys in phrase by querying for existing tags and / or key name. you can search for multiple tags at once and a broad search on key name using the `*` wildcard. keep in mind the query is an AND query, meaning the keys have to match all criteria.

Tip

if you want to match **all** keys, simply omit the query-key (`-k`) and query-tag (`-t`) options

**example**:

```
php bin/console phrase:keys:tag -k error.* -t ticket-15 -t ticket-13 --tag epic-5
```

this will search for all keys matching the name `error.*` and with tags `ticket-15` AND `ticket-13` and will add the tag `epic-5` to them.

when you add the `--dry-run` option to the command, it will list the first 100 matches to your query.

### `phrase:keys:untag` command

[](#phrasekeysuntag-command)

this command helps you to batch remove tags from keys in phrase by querying for existing tags and / or key name. you can search for multiple tags at once and a broad search on key name using the `*` wildcard. keep in mind the query is an AND query, meaning the keys have to match all criteria.

Tip

if you want to match **all** keys, simply omit the query-key (`-k`) and query-tag (`-t`) options

**example**:

```
php bin/console phrase:keys:untag -k error.* -t ticket-15 -t ticket-13 --tag epic-5
```

this will search for all keys matching the name `error.*` and with tags `ticket-15` AND `ticket-13` and will remove the tag `epic-5` from them.

when you add the `--dry-run` option to the command, it will list the first 100 matches to your query.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance62

Regular maintenance activity

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 95.6% 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 ~118 days

Recently: every ~86 days

Total

10

Last Release

170d ago

Major Versions

1.0.0 → 2.0.02023-02-03

2.4.0 → 3.0.02025-03-09

3.2.0 → 4.0.02025-11-29

PHP version history (6 changes)1.0.0PHP ~8.1.0 || ~8.2.0

2.1.0PHP ~8.2.0 || ~8.3.0

2.3.0PHP ~8.2.0 || ~8.3.0 || ~8.4.0

3.0.0PHP ~8.3.0 || ~8.4.0

3.2.0PHP ~8.3.0 || ~8.4.0 || ~8.5.0

4.0.0PHP ~8.4.0 || ~8.5.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/343850?v=4)[wickedOne](/maintainers/wickedOne)[@wickedOne](https://github.com/wickedOne)

---

Top Contributors

[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (763 commits)")[![wickedOne](https://avatars.githubusercontent.com/u/343850?v=4)](https://github.com/wickedOne "wickedOne (33 commits)")[![tacman](https://avatars.githubusercontent.com/u/619585?v=4)](https://github.com/tacman "tacman (2 commits)")

---

Tags

phrasesymfonysymfony-bundletranslations

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/wickedone-phrase-tag-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/wickedone-phrase-tag-bundle/health.svg)](https://phpackages.com/packages/wickedone-phrase-tag-bundle)
```

###  Alternatives

[sylius/sylius

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

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[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)[sulu/sulu

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

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

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)

PHPackages © 2026

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