richarddobron / fbt
An Internationalization Framework for PHP.
Requires
- php: ^7.2 || ^8.0
- ext-dom: *
- ext-iconv: *
- ext-json: *
- ext-mbstring: *
- minicli/minicli: 1.0.4
- nikic/php-parser: ^4.1 || ^5.0
- richarddobron/dom-forge: ^2.0.1
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.2.1
- latte/latte: ^2.5 || ^3.0
- phpunit/phpunit: ^8.5.5 || ^9.3.5
- spatie/phpunit-snapshot-assertions: ^2.0|^3.0|^4.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-main
- 5.1.0
- 5.0.0
- 4.x-dev
- 4.4.0
- 4.3.4
- 4.3.3
- 4.3.2
- 4.3.1
- 4.3.0
- 4.2.9
- 4.2.8
- 4.2.7
- 4.2.6
- 4.2.5
- 4.2.4
- 4.2.3
- 4.2.2
- 4.2.1
- 4.2.0
- 4.1.0
- 4.0.11
- 4.0.10
- 4.0.9
- 4.0.8
- 4.0.7
- 4.0.6
- 4.0.5
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0
- 3.x-dev
- 3.3.4
- 3.3.3
- 3.3.2
- 3.3.1
- 3.3.0
- 3.2.9
- 3.2.8
- 3.2.7
- 3.2.6
- 3.2.5
- 3.2.4
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.0
- 3.0.11
- 3.0.10
- 3.0.9
- 3.0.8
- 3.0.7
- 3.0.6
- 3.0.5
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0
This package is auto-updated.
Last update: 2026-10-01 21:19:49 UTC
README
FBT for PHP
FBT is an internationalization framework for PHP designed to be not just powerful and flexible, but also simple and intuitive. It helps with the following:
- Organizing your source text for translation
- Composing grammatically correct translatable UI
- Eliminating verbose boilerplate for generating UI
This library is based on the JavaScript implementation of Facebook's FBT and its maintained fork fbtee.
π Requirements
- PHP 7.0 or higher
- Composer is required for installation
π¦ Installing
$ composer require richarddobron/fbt:^5
β¨ Features
- Parameters and interpolation
- Implicit parameters
- Auto-parameterization
- Plurals
- Enumerations
- Pronouns
- Lists
- Number formatting
- Phrase extracting
- Inline translating
π Getting started
See the Getting Started guide for more.
π Version Guidance
| Version | Released | Status | Repo | PHP Version |
|---|---|---|---|---|
| 3.x | 2022-02-18 | Unsupported | v3 | >= 7.0 |
| 4.x | 2022-04-09 | Unsupported | v4 | >= 7.2 |
| 5.x | 2026-09-25 | Latest | v5 | >= 7.2 |
π Official integrations
The following integrations are fully supported and maintained:
Built-in support:
- Latte:
{fbt(...)}is rendered without escaping, andcollect-fbtscollects the strings of.lattetemplates (requireslatte/latte)
βοΈ How FBT works
Like Facebook's fbt, FBT creates tables of all possible variations for each fbt phrase and
accesses them at runtime. fbt(...) callsites are compiled from their constructs (e.g. fbt::param()),
and <fbt> constructs are parsed via DOM Forge. Each callsite is compiled once, its strings
are extracted for translation, and the translated payloads are looked up during execution.
β¬οΈ Upgrading
See UPGRADE-5.0.md for upgrading from 4.x to 5.0.
π Full documentation
β TODO
- Add driver-agnostic support for multiple database systems.
- Add integrations for Symfony, CakePHP, Zend Framework, ...
- ...
π€ Contributing
Please see CONTRIBUTING for details.
π License
This project is licensed under the MIT License. See the LICENSE file for details.