PHPackages                             byjg/fonemabr - 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. [Utility & Helpers](/categories/utility)
4. /
5. byjg/fonemabr

ActiveLibrary[Utility & Helpers](/categories/utility)

byjg/fonemabr
=============

O Fonema BR tem por objetivo criar uma simplificação de palavras de tal forma que erros de ortografia e vogais não interfiram na busca

6.0.0(5mo ago)28.7k↓40.9%MITPHPPHP >=8.3 <8.6CI passing

Since Apr 21Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/byjg/php-fonemabr)[ Packagist](https://packagist.org/packages/byjg/fonemabr)[ GitHub Sponsors](https://github.com/byjg)[ RSS](/packages/byjg-fonemabr/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (3)Versions (9)Used By (0)

Fonema BR
=========

[](#fonema-br)

[![Sponsor](https://camo.githubusercontent.com/fab14b7f7f475072ada0473f193d6f322561fd4a2958e0cc89910d053347cf27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53706f6e736f722d2532336561346161613f6c6f676f3d67697468756273706f6e736f7273266c6f676f436f6c6f723d7768697465266c6162656c436f6c6f723d306431313137)](https://github.com/sponsors/byjg)[![Build Status](https://github.com/byjg/php-fonemabr/actions/workflows/phpunit.yml/badge.svg?branch=master)](https://github.com/byjg/php-fonemabr/actions/workflows/phpunit.yml)[![Opensource ByJG](https://camo.githubusercontent.com/425c1bbccc0f292bf4d20569ae74a6b2e384fd648f1af8911bc61de9a8dcfc0b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e736f757263652d62796a672d737563636573732e737667)](http://opensource.byjg.com)[![GitHub source](https://camo.githubusercontent.com/88e61eb211719144efdd570290a0456b6e13099c2df8d973f1bb43fe33bf0039/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4769746875622d736f757263652d696e666f726d6174696f6e616c3f6c6f676f3d676974687562)](https://github.com/byjg/php-fonemabr/)[![GitHub license](https://camo.githubusercontent.com/90027171034b6101b30d58be810ec27a357d0ec20132bc4e5c35a92346f3b2b5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f62796a672f7068702d666f6e656d6162722e737667)](https://opensource.byjg.com/opensource/licensing.html)[![GitHub release](https://camo.githubusercontent.com/ae6ceca97818d1afd038b7b4322101ae40ec88f8aafda26f5ede7950e631bac4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f62796a672f7068702d666f6e656d6162722e737667)](https://github.com/byjg/uri/releases/)

O Fonema BR tem por objetivo criar uma simplificação de palavras de tal forma que erros de ortografia e vogais não interfiram na busca. Dessa forma, é possível criar sistemas de buscas mais aproximados com o brasileiro e aumentar a assertividade da busca.

**Observação**: Apesar do nome "Fonema" a classe não é uma representação fiel dos fonemas brasileiros sendo apenas uma simplificação.

*Nem todas as situações foram testadas. Caso encontre alguma divergência, por favor, sinta-se à vontade para fazer um pull request*

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

[](#installation)

```
composer require byjg/fonemabr
```

[More details](docs/install.md)

Exemplos
--------

[](#exemplos)

### Metafone

[](#metafone)

```
$metaphone = new \ByJG\WordProcess\Portuguese\Metaphone();

echo $metaphone->convert('brasília'); // Output: BRAZILIA
echo $metaphone->convert('brazilia'); // Output: BRAZILIA
```

[More details](docs/metaphone.md)

### Soundex

[](#soundex)

```
use ByJG\WordProcess\Portuguese\Soundex;

echo Soundex::process('brasília'); // Output: B625
echo Soundex::process('brazilia'); // Output: B625
echo Soundex::process('brasil');   // Output: B625
```

[More details](docs/soundex.md)

Use Cases
---------

[](#use-cases)

Uma possível utilização é criar um segundo campo no banco de dados no qual o fonema será armazenado. Sempre que salvar a palavra original você também salva a palavra com fonema.

Dessa forma você poderá pesquisar tanto a palavra original quanto a palavra simplifica com o Fonema.

[More details and examples](docs/use-cases.md)

Dependencies
------------

[](#dependencies)

 ```
flowchart TD
    byjg/fonemabr --> byjg/convert
```

      Loading ---

[Open source ByJG](http://opensource.byjg.com)

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance70

Regular maintenance activity

Popularity26

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90.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 ~553 days

Recently: every ~172 days

Total

8

Last Release

175d ago

Major Versions

1.0.0 → 2.0.02018-02-19

2.0.0 → 4.9.x-dev2024-01-05

4.9.0 → 5.0.x-dev2024-10-27

5.0.0 → 6.0.02025-11-24

PHP version history (3 changes)4.9.x-devPHP >=7.4

5.0.x-devPHP >=8.1 <8.4

6.0.0PHP >=8.3 <8.6

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/981924?v=4)[Joao Gilberto Magalhaes](/maintainers/byjg)[@byjg](https://github.com/byjg)

---

Top Contributors

[![byjg](https://avatars.githubusercontent.com/u/981924?v=4)](https://github.com/byjg "byjg (38 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (4 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/byjg-fonemabr/health.svg)

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

###  Alternatives

[lkwdwrd/wp-muplugin-loader

A drop-in MU Plugin loader for WordPress

5847.1k](/packages/lkwdwrd-wp-muplugin-loader)

PHPackages © 2026

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