PHPackages                             devopsadmins/text-helpers - 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. devopsadmins/text-helpers

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

devopsadmins/text-helpers
=========================

Serviço de manipulação de texto de alta performance para projetos em Laravel.

v0.0.6(3mo ago)010MITPHPPHP ^8.2

Since Feb 17Pushed 3mo agoCompare

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

READMEChangelogDependencies (2)Versions (7)Used By (0)

String ToolKit for Arbe
=======================

[](#string-toolkit-for-arbe)

Biblioteca de manipulação de strings de alta performance, otimizada para o ecossistema Laravel e desenvolvida com foco em segurança de tipos (`readonly class`) e eficiência.

📋 Requisitos
------------

[](#-requisitos)

- **PHP**: ^8.2
- **Laravel**: ^10.0 / ^11.0 / ^12.0

🚀 Instalação
------------

[](#-instalação)

Instale o pacote via Composer:

```
composer require devopsadmins/text-helpers
```

> **Autodiscovery**: O Laravel registrará automaticamente o `TextHelperServiceProvider`.

🛠 Como Usar
-----------

[](#-como-usar)

O pacote oferece duas formas de uso:

1. **Acesso Direto**: `text()->método()`
2. **Interface Fluida (Method Chaining)**: `text("valor")->método1()->método2()`

### Interface Fluida (Recomendado)

[](#interface-fluida-recomendado)

A interface fluida permite encadear múltiplas operações de forma elegante e legível:

```
// Exemplo: Limpa, formata e abrevia um nome
echo text("  VINICIUS DIAS DE SOUZA  ")
    ->clean()
    ->formatName()
    ->abbreviate(20);
// Resultado: "Vinícius D. Souza"

// Exemplo: Processa um slug customizado
echo text("@devops_admins #laravel")
    ->slugWithSpecialChars(['@', '#']);
// Resultado: "@devops-admins-#laravel"

// Exemplo: Converte markdown e formata
echo text("# **João Da Silva**")
    ->markdownToPlainText()
    ->formatName();
// Resultado: "João da Silva"
```

### Helper Global `text()`

[](#helper-global-text)

A maneira mais rápida de acessar as ferramentas é através do helper global `text()`.

#### 1. Separar Nome e Sobrenome (`splitName`)

[](#1-separar-nome-e-sobrenome-splitname)

Ideal para normalizar inputs de cadastro ou saídas de API.

```
$fullName = "Vinícius Dias de Souza";

$data = text()->splitName($fullName);

// Resultado:
// [
//     'firstName' => 'Vinícius',
//     'lastName'  => 'Dias de Souza'
// ]

echo $data['firstName']; // Vinícius

// Modo fluido
$data = text("Vinícius Dias de Souza")->splitName();
```

#### 2. Abreviar Nomes Longos (`abbreviate`)

[](#2-abreviar-nomes-longos-abbreviate)

Formata nomes para caber em layouts restritos (listagens, boletos, crachás), preservando o primeiro e último nome.

```
// Abrevia se for maior que o limite (padrão 20 chars)
echo text()->abbreviate("Vinícius Dias de Souza");
// Saída: "Vinícius D. Souza"

// Com limite personalizado
echo text()->abbreviate("Maria da Silva", 50);
// Saída: "Maria da Silva" (não abrevia pois cabe no limite)

// Modo fluido
echo text("Vinícius Dias de Souza")->abbreviate(20);
```

#### 3. Formatar Nomes Próprios (`formatName`)

[](#3-formatar-nomes-próprios-formatname)

Converte nomes para *Title Case*, respeitando preposições em português (`de`, `da`, `dos`, `e`, etc.) que devem permanecer em minúsculo.

```
echo text()->formatName("VINICIUS DE SOUZA");
// Saída: "Vinícius de Souza"

// Modo fluido
echo text("VINICIUS DE SOUZA")->formatName();
```

#### 4. Mascarar Dados Sensíveis (`mask`)

[](#4-mascarar-dados-sensíveis-mask)

Ofusca partes de uma string. Detecta automaticamente e-mails para mascarar tanto o usuário quanto o domínio.

```
// Email
echo text()->mask("everton@gmail.com");
// Saída: "eve*****@g****.com"

// CPF / Outros (mantém os primeiros X caracteres visíveis)
echo text()->mask("12345678900", 3);
// Saída: "123********"

// Modo fluido
echo text("everton@gmail.com")->mask();
```

#### 5. Extração de Iniciais (`initials`)

[](#5-extração-de-iniciais-initials)

Gera iniciais a partir de um nome, ideal para avatares (User Interface).

```
echo text()->initials("Vinícius Dias de Souza");
// Saída: "VS"

// Modo fluido
echo text("Vinícius Dias de Souza")->initials();
```

#### 6. Limpeza de Input (`clean`)

[](#6-limpeza-de-input-clean)

Remove caracteres invisíveis, espaços duplos, tabs e quebras de linha desnecessárias. Essencial para higienizar dados colados de PDFs ou planilhas.

```
echo text()->clean("  Nome    Sobrenome  ");
// Saída: "Nome Sobrenome"

// Modo fluido
echo text("  Nome    Sobrenome  ")->clean();
```

#### 7. Estimativa de Tempo de Leitura (`readTime`)

[](#7-estimativa-de-tempo-de-leitura-readtime)

Calcula o tempo estimado de leitura em minutos, baseado em uma média de palavras por minuto (padrão: 200 PPM).

```
$minutes = text()->readTime($conteudoLongo);
echo "$minutes min de leitura";

// Modo fluido
$minutes = text($conteudoLongo)->readTime();
```

#### 8. Verificador de Termos Ofensivos (`isClean`)

[](#8-verificador-de-termos-ofensivos-isclean)

Verifica se o texto contém termos de uma lista de bloqueio (profanity filter).

```
if (! text()->isClean($comentario)) {
    abort(403, "Conteúdo inadequado.");
}

// Modo fluido
if (! text($comentario)->isClean()) {
    abort(403, "Conteúdo inadequado.");
}
```

#### 9. IDs Curtos Legíveis (`shortId`)

[](#9-ids-curtos-legíveis-shortid)

Gera identificadores únicos curtos e amigáveis para humanos (sem caracteres ambíguos como `0`, `O`, `1`, `l`). Ideal para URLs curtas ou códigos de cupom.

```
echo text()->shortId(6);
// Saída Ex: "K9P3XZ"
```

🔥 Funcionalidades Avançadas
---------------------------

[](#-funcionalidades-avançadas)

### 10. Slug Customizado (`slugWithSpecialChars`)

[](#10-slug-customizado-slugwithspecialchars)

Cria slugs mantendo caracteres especiais especificados. Perfeito para sistemas de menções e hashtags.

```
echo text()->slugWithSpecialChars("@devops_admins #laravel", ['@', '#']);
// Saída: "@devops-admins-#laravel"

// Slug padrão
echo text("Hello World!")->slug();
// Saída: "hello-world"

// Com separador customizado
echo text("Hello World")->slugWithSpecialChars([], '_');
// Saída: "hello_world"
```

### 11. Truncar HTML Inteligente (`truncateHtml`)

[](#11-truncar-html-inteligente-truncatehtml)

Corta HTML sem quebrar tags, mantendo a estrutura válida.

```
$html = 'Este é um texto longo com HTML.';

echo text()->truncateHtml($html, 20);
// Saída: "Este é um texto..."

// Modo fluido
echo text($html)->truncateHtml(20, '...');
```

### 12. Destacar Palavras-chave (`highlight`)

[](#12-destacar-palavras-chave-highlight)

Envolve termos de busca em tags HTML (padrão: ``), mantendo o case original.

```
echo text()->highlight("O Laravel é incrível", "laravel");
// Saída: "O Laravel é incrível"

// Múltiplas palavras
echo text()->highlight("Laravel e PHP", ["laravel", "php"]);
// Saída: "Laravel e PHP"

// Tag customizada
echo text("Laravel")->highlight("laravel", "span");
// Saída: "Laravel"
```

### 13. Gerenciar Emojis

[](#13-gerenciar-emojis)

#### Remover Emojis (`stripEmojis`)

[](#remover-emojis-stripemojis)

Útil para bancos de dados que não suportam `utf8mb4`.

```
echo text()->stripEmojis("Olá! 😀");
// Saída: "Olá!"

// Modo fluido
echo text("Olá! 😀")->stripEmojis();
```

#### Converter Shortcodes (`emojify`)

[](#converter-shortcodes-emojify)

```
echo text()->emojify("Isso é :fire: demais :thumbsup:");
// Saída: "Isso é 🔥 demais 👍"

// Modo fluido
echo text("Hello :smile:")->emojify();
// Saída: "Hello 😀"
```

Shortcodes suportados: `:smile:`, `:heart:`, `:fire:`, `:thumbsup:`, `:rocket:`, `:party:`, entre outros.

### 14. Valor Monetário por Extenso (`moneyToWords`)

[](#14-valor-monetário-por-extenso-moneytowords)

Converte valores monetários para extenso em português (Brasil). Essencial para contratos, recibos e documentos fiscais.

```
echo text()->moneyToWords(150.50);
// Saída: "cento e cinquenta reais e cinquenta centavos"

echo text()->moneyToWords(1.00);
// Saída: "um real"

echo text()->moneyToWords(2000.10);
// Saída: "dois mil reais e dez centavos"

echo text()->moneyToWords(1000000);
// Saída: "um milhão reais"
```

### 15. Extrair Menções e Hashtags

[](#15-extrair-menções-e-hashtags)

#### Extrair Menções (`extractMentions`)

[](#extrair-menções-extractmentions)

```
$text = "Olá @usuario1, você viu o que @usuario2 postou? @usuario1 está incrível!";
$mentions = text()->extractMentions($text);
// Resultado: ['usuario1', 'usuario2'] (sem duplicatas)

// Modo fluido
$mentions = text($text)->extractMentions();
```

#### Extrair Hashtags (`extractHashtags`)

[](#extrair-hashtags-extracthashtags)

```
$text = "Adoro #Laravel e #PHP! #Laravel é o melhor.";
$hashtags = text()->extractHashtags($text);
// Resultado: ['Laravel', 'PHP'] (sem duplicatas)

// Modo fluido
$hashtags = text($text)->extractHashtags();
```

### 16. Markdown para Texto Plano (`markdownToPlainText`)

[](#16-markdown-para-texto-plano-markdowntoplaintext)

Remove toda formatação Markdown, ideal para prévias de e-mail ou descrições meta.

```
$markdown = '# Título\n\nEste é um **texto** em _markdown_ com [link](http://example.com).';

echo text()->markdownToPlainText($markdown);
// Saída: "Título\n\nEste é um texto em markdown com link."

// Modo fluido
echo text($markdown)->markdownToPlainText();
```

🔗 Métodos Adicionais da Interface Fluida
----------------------------------------

[](#-métodos-adicionais-da-interface-fluida)

A classe `FluentString` também oferece métodos auxiliares para manipulação comum:

```
// Case transformation
text("hello")->upper()              // "HELLO"
text("HELLO")->lower()              // "hello"
text("hello world")->title()        // "Hello World"

// String manipulation
text("  spaces  ")->trim()          // "spaces"
text("Hello World")->replace("World", "Laravel")  // "Hello Laravel"
text("Long text...")->limit(5)      // "Long ..."

// Verificações (retornam bool)
text("Hello World")->contains("World")     // true
text("Hello")->startsWith("Hel")          // true
text("Hello")->endsWith("lo")             // true
text("")->isEmpty()                       // true
text("Hello")->isNotEmpty()               // true
text("Hello")->length()                   // 5
```

💡 Exemplos Práticos de Uso
--------------------------

[](#-exemplos-práticos-de-uso)

### Processamento de Formulário

[](#processamento-de-formulário)

```
$nomeFormatado = text($request->input('nome'))
    ->clean()
    ->formatName()
    ->toString();
```

### Sistema de Blog

[](#sistema-de-blog)

```
// Tempo de leitura e resumo
$tempoLeitura = text($post->conteudo)->readTime();
$resumo = text($post->conteudo_html)->truncateHtml(150);

// Extração de metadados
$mentions = text($post->conteudo)->extractMentions();
$hashtags = text($post->conteudo)->extractHashtags();
```

### Geração de Documentos

[](#geração-de-documentos)

```
$valorExtenso = text()->moneyToWords($invoice->total);
// "mil duzentos e trinta reais e quarenta e cinco centavos"
```

### Sistema de Busca

[](#sistema-de-busca)

```
$resultadoDestacado = text($conteudo)->highlight($termoBusca, 'mark');
```

### Injeção de Dependência

[](#injeção-de-dependência)

Se preferir não usar helpers globais, você pode injetar o serviço diretamente em Controllers, Jobs ou outros Serviços.

```
use Arbe\TextHelpers\Services\StringToolkit;

class CustomerController extends Controller
{
    public function __construct(
        private readonly StringToolkit $text
    ) {}

    public function store(Request $request)
    {
        $name = $this->text->abbreviate($request->input('name'));

        // ...
    }
}
```

✅ Testes e Qualidade
--------------------

[](#-testes-e-qualidade)

O pacote inclui uma suíte de testes automatizados utilizando **PHPUnit** e **Orchestra Testbench**, cobrindo 100% das funcionalidades críticas.

### Executando os Testes

[](#executando-os-testes)

Para rodar a bateria de testes localmente:

```
composer test
```

### Estrutura

[](#estrutura)

- **Unitários** (`tests/Unit`): Valida cada método da classe `StringToolkit` isoladamente.
- **Integração** (`tests/Feature`): Garante que o pacote se comporta corretamente dentro do container Laravel.

### Automação (Git Hook)

[](#automação-git-hook)

Para prevenir erros em produção, este repositório conta com um hook de **pre-push**. Sempre que você executar `git push`, os testes serão rodados automaticamente. Se algum teste falhar, o envio é bloqueado.

> O script de verificação encontra-se em `.git/hooks/pre-push`.

⚙️ Características Técnicas
---------------------------

[](#️-características-técnicas)

- **Imutabilidade**: Implementado como `readonly class` do PHP 8.2+, prevenindo modificações acidentais de estado.
- **UTF-8 Safe**: Utiliza funções `mb_*` para garantir o tratamento correto de acentos e caracteres especiais.
- **Performance**: Otimizado para baixo consumo de memória, registrado como Singleton no container do Laravel.

📝 Licença
---------

[](#-licença)

MIT License.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance78

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~0 days

Total

6

Last Release

113d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d8c3305462033ac48755e815951657cb8bc632a9269195acc25e3cb04954b6b?d=identicon)[devopsadmins](/maintainers/devopsadmins)

---

Top Contributors

[![devopsadmins](https://avatars.githubusercontent.com/u/903960?v=4)](https://github.com/devopsadmins "devopsadmins (6 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/devopsadmins-text-helpers/health.svg)

```
[![Health](https://phpackages.com/badges/devopsadmins-text-helpers/health.svg)](https://phpackages.com/packages/devopsadmins-text-helpers)
```

###  Alternatives

[naucon/breadcrumbs

The breadcrumb package helps to integrate a common breadcrumb navigation into a web application. The package includes two components: A breadcrumbs class to add breadcrumb elements and a breadcrumbs helper to render html markup in php or smarty templates.

1226.6k](/packages/naucon-breadcrumbs)[dotmarn/laravel-error-views

A set of customised error pages/screens designed using the TailwindCSS for use in Laravel projects.

133.9k](/packages/dotmarn-laravel-error-views)

PHPackages © 2026

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