Search by

richarddobron / laravel-fbt

dobron

A PHP Internationalization Framework for Laravel Application.

Package info

github.com/richardDobron/laravel-fbt

pkg:composer/richarddobron/laravel-fbt

Statistics

Installs: 10 671

Dependents: 0

Suggesters: 0

Stars: 12

Open Issues: 0

5.1.0 2026-10-02 08:18 UTC

README

FBT

FBT for Laravel

Latest Version on Packagist MIT Licensed Test Status Total Downloads

FBT is an internationalization framework for Laravel Application 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.

FBT intro

FBT plurals

FBT enum

FBT pronouns

πŸ“– Requirements

  • Laravel 5.5 or higher
  • Composer is required for installation

πŸ“¦ Installing

$ composer require richarddobron/laravel-fbt

✨ Features

  • Parameters and interpolation
  • Implicit parameters
  • Auto-parameterization
  • Plurals
  • Enumerations
  • Pronouns
  • Number formatting
  • Phrase extracting
  • Inline translating

πŸš€ Getting started

Integrating into your app

πŸ“‘ Version Guidance

Version Released Status Repo Laravel Version PHP Version
3.x 2022-02-21 Unsupported v3 ^5.5 ^7.0
4.x 2022-04-09 Unsupported v4 ^5.6|^5.7|^5.8|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0 ^7.2|^8.0
5.x 2026-09-26 Latest v5 ^5.6|^5.7|^5.8|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0 ^7.2|^8.0

βš™οΈ 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.md for upgrading to fbt 5.

πŸ“• Full documentation

🀝 Contributing

Please see CONTRIBUTING for details.

πŸ“œ License

This project is licensed under the MIT License. See the LICENSE file for details.