PHPackages                             opencat/terminology - 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. [Framework](/categories/framework)
4. /
5. opencat/terminology

ActiveLibrary[Framework](/categories/framework)

opencat/terminology
===================

Term recognition and TBX import for the OpenCAT Framework

00PHP

Since May 9Pushed 1mo agoCompare

[ Source](https://github.com/shaikhammar/opencat-terminology)[ Packagist](https://packagist.org/packages/opencat/terminology)[ RSS](/packages/opencat-terminology/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

opencat/terminology
===================

[](#opencatterminology)

Term recognition and TBX import for the [OpenCAT Framework](https://github.com/shaikhammar/opencat-framework).

Parses TBX v2 (ISO 30042) glossary files and stores terms in SQLite. At translation time, scans source text for known terms and returns their target-language equivalents so the translator sees glossary matches alongside TM matches.

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

[](#installation)

```
composer require opencat/terminology
```

Requires `ext-dom`, `ext-intl`, `ext-mbstring`, `ext-pdo`, and `ext-pdo_sqlite`.

Usage
-----

[](#usage)

```
use CatFramework\Terminology\Provider\SqliteTerminologyProvider;

$provider = new SqliteTerminologyProvider('glossary.db');
// SQLite schema is created automatically

// Import a TBX file
$count = $provider->import('legal-terms.tbx');
echo "Imported {$count} term entries";

// Recognise terms in source text
$matches = $provider->recognize(
    text: 'Please review the translation memory for consistency.',
    sourceLanguage: 'en',
    targetLanguage: 'fr',
);

foreach ($matches as $match) {
    echo $match->entry->sourceTerm . ' → ' . $match->entry->targetTerm . PHP_EOL;
    echo "Found at offset {$match->offset}, length {$match->length}" . PHP_EOL;
}
```

TBX parser
----------

[](#tbx-parser)

The `TbxParser` handles both TBX v2 (`` root, ``, ``) and TBX-Basic (`` root, ``, ``):

```
use CatFramework\Terminology\Parser\TbxParser;

$parser = new TbxParser();
$entries = $parser->parseFile('glossary.tbx');   // returns TermEntry[]
// or from a string:
$entries = $parser->parseString($xmlString);
```

Each `TermEntry` carries:

- `$sourceTerm` / `$targetTerm` — the term text
- `$sourceLanguage` / `$targetLanguage` — BCP 47 codes
- `$definition` — extracted from ``
- `$domain` — extracted from ``
- `$forbidden` — `true` when `administrativeStatus` is `deprecatedTerm` or `supersededTerm`

If a concept has multiple terms per language, all source × target combinations are generated as individual `TermEntry` objects.

TBX file example
----------------

[](#tbx-file-example)

```

            translation memory
            A database of previously translated segments.

            mémoire de traduction

```

Term recognition
----------------

[](#term-recognition)

`recognize()` uses Unicode-aware word-boundary detection rather than regex `\b` — which is byte-level and breaks for Arabic and Devanagari. Boundaries are detected using space and punctuation characters, making it safe for Hindi, Urdu, and Arabic terms.

Longer terms are matched preferentially over shorter ones when they overlap (greedy left-to-right scan).

Forbidden terms
---------------

[](#forbidden-terms)

Terms imported with `administrativeStatus = deprecatedTerm` or `supersededTerm` are stored as forbidden. The [`opencat/qa`](https://github.com/shaikhammar/opencat-framework/tree/main/packages/qa) `TerminologyConsistencyCheck` flags target segments that use a forbidden term instead of its approved equivalent.

Related packages
----------------

[](#related-packages)

- [`opencat/core`](https://github.com/shaikhammar/opencat-framework/tree/main/packages/core) — `TermEntry`, `TermMatch`, `TerminologyProviderInterface`, `TerminologyException`
- [`opencat/qa`](https://github.com/shaikhammar/opencat-framework/tree/main/packages/qa) — `TerminologyConsistencyCheck` uses `TerminologyProviderInterface`
- [`opencat/workflow`](https://github.com/shaikhammar/opencat-framework/tree/main/packages/workflow) — wires `SqliteTerminologyProvider` into the pipeline

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance61

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

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

---

Top Contributors

[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (3 commits)")

### Embed Badge

![Health badge](/badges/opencat-terminology/health.svg)

```
[![Health](https://phpackages.com/badges/opencat-terminology/health.svg)](https://phpackages.com/packages/opencat-terminology)
```

###  Alternatives

[laravel/socialite

Laravel wrapper around OAuth 1 & OAuth 2 libraries.

5.7k104.3M822](/packages/laravel-socialite)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k38.6M289](/packages/laravel-dusk)[pinguo/php-msf

Pinguo Micro Service Framework For PHP

1.7k4.2k](/packages/pinguo-php-msf)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)

PHPackages © 2026

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